pm-presets 2026.6.2 → 2026.6.3-1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 2026.6.3-1 - 2026-06-03
+
+### Added
+
+- Deepen presets toolset: add show, diff, validate, enrich list ([pm-ruih](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/features/pm-ruih.toon))
+
+### Other
+
+- Unit tests + functional test against real workspace + release 2026.6.3 ([pm-q60r](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-q60r.toon))
+
+## 2026.06.03 - 2026-06-02
+
+### Added
+
+- Enrich presets list output + add --json; document apply idempotency ([pm-g9oh](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-g9oh.toon))
+
+### Other
+
+- DECISION: apply idempotency, --with-seeds, and capability array ([pm-cj9x](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-cj9x.toon))
+- Implement presets validate \(all bundled presets parse/load\) ([pm-e2qb](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-e2qb.toon))
+- Implement presets diff <name\> \(workspace vs preset, --json\) ([pm-xa8m](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-xa8m.toon))
+- Implement presets show <name\> \(full definition, --json, exit 3\) ([pm-0r28](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/tasks/pm-0r28.toon))
+
 ## 2026.06.01 - 2026-06-01
 
 ### Fixed

package/README.md

@@ -17,6 +17,9 @@ pm install github.com/unbraind/pm-presets --project
 | **open-source** | `pm oss-setup` | standard | OSS maintainers with community contributors |
 | **software-sprint** | `pm sprint-setup` | standard | Engineering teams running sprints |
 | **startup-roadmap** | `pm roadmap-setup` | custom | Startups with investor-facing roadmaps |
+| **kanban** | `pm kanban-setup` | minimal | Continuous-flow boards with a custom `Card` item type |
+
+Run `pm presets list` for the full, machine-readable catalog.
 
 ## Usage
 
@@ -36,7 +39,7 @@ pm install github.com/unbraind/pm-presets --project
    pm roadmap-setup       # startup roadmap
    ```
 
-All commands share the same flags:
+All setup commands share the same flags:
 
 | Flag | Short | Description |
 |---|---|---|
@@ -48,6 +51,56 @@ Each setup command installs valid `pm create` templates and registers the
 `templates show` runtime handler required by the current pm CLI, so
 `pm create --template <name>` works after installing and applying this package.
 
+## Managing presets
+
+Beyond the per-preset `*-setup` aliases, pm-presets ships a unified, read-only
+management surface plus a generic `apply`:
+
+| Command | Description |
+|---|---|
+| `pm presets list` | Enumerate every bundled preset and what it configures (governance, built-in + custom item types, templates). |
+| `pm presets show <id>` | Print the full definition of one preset: the settings patch it merges, every template (with its `pm create` option keys), and any custom item types it registers. |
+| `pm presets diff <id>` | Compare the current workspace (`settings.json` + installed templates) against a preset and report what `apply` would add / change, plus which templates are missing. |
+| `pm presets validate` | Validate that all bundled presets parse and load coherently (governance enums, template names/options, registry↔export agreement). |
+| `pm presets apply <id>` | Scaffold a preset into the current workspace (the generic form of the `*-setup` commands). |
+
+All of the read-only commands accept `--json` for machine-readable output, and
+all commands accept `--help`. An unknown preset id exits with code `3`
+(`NOT_FOUND`).
+
+```bash
+pm presets list
+pm presets show software-sprint --json
+pm presets diff software-sprint           # what would change if I applied it?
+pm presets validate
+pm presets apply software-sprint --dry-run
+```
+
+### `presets apply` flags
+
+`presets apply` accepts the shared `--force` / `--dry-run` / `--prefix` flags,
+plus:
+
+| Flag | Short | Description |
+|---|---|---|
+| `--with-seeds` | `-s` | Also create the preset's starter items after applying it. |
+
+**Idempotency & safety.** `apply` is safe to re-run:
+
+- `settings.json` is **deep-merged** — the preset's keys are layered over your
+  existing settings, so unrelated config (telemetry, locks, etc.) is preserved.
+- Templates are **skipped if a file with that name already exists**; pass
+  `--force` to overwrite them.
+- `--dry-run` previews every settings merge, template write, and seed item
+  without touching disk.
+
+**Seeds and custom fields (pm-cli #97).** Starter items created by
+`--with-seeds` set only **built-in** fields (`type`, `title`, `priority`,
+`tags`, `body`). Custom scalar fields registered via `registerItemFields` have
+no `pm create --<field>` setter today, so any preset-specific context lives in
+the seed item's body text rather than in custom options. The kanban `Card`
+type *is* a registered item type, so its seed is created as `--type Card`.
+
 ## Presets in Detail
 
 ### bug-triage

package/dist/catalog.d.ts

@@ -0,0 +1,93 @@
+/**
+ * catalog.ts — structured, read-only views over the bundled presets.
+ *
+ * The individual preset modules export their SETTINGS / TEMPLATES (and, for
+ * kanban, ITEM_TYPES). This module joins those raw exports with the
+ * PRESET_REGISTRY descriptors and derives the higher-level views consumed by
+ * the read-only commands `presets show`, `presets diff`, and `presets validate`
+ * (plus the enriched `presets list`).
+ *
+ * Everything here is pure: no filesystem, no process exit, no SDK runtime. That
+ * keeps it unit-testable with `node --test` and side-effect free.
+ */
+import type { PresetSettingsPatch } from "./presets/shared.js";
+import { type PresetDescriptor } from "./registry.js";
+/** A minimally-typed mirror of the SDK's SchemaItemTypeDefinition. */
+export interface PresetItemTypeView {
+    name: string;
+    aliases: string[];
+    options: Array<{
+        key: string;
+        values: string[];
+    }>;
+}
+/** A single template summarized for human and JSON consumption. */
+export interface PresetTemplateView {
+    name: string;
+    /** The built-in pm item type the template creates (e.g. "Issue"). */
+    type: string;
+    /** All `pm create` option keys the template sets (sorted). */
+    optionKeys: string[];
+}
+/** The full, structured definition of one preset. */
+export interface PresetDefinition {
+    id: string;
+    displayName: string;
+    description: string;
+    command: string;
+    idPrefix: string;
+    governance: PresetDescriptor["governance"];
+    /** The settings.json patch this preset deep-merges on apply. */
+    settings: PresetSettingsPatch;
+    /** Templates this preset installs. */
+    templates: PresetTemplateView[];
+    /** Custom item types registered at activation (kanban only today). */
+    itemTypes: PresetItemTypeView[];
+}
+/** All preset definitions in registry order. */
+export declare function listPresetDefinitions(): PresetDefinition[];
+/**
+ * Find one preset definition by id (case-insensitive, trimmed).
+ *
+ * Returns `undefined` for unknown names so callers decide the error contract;
+ * `requirePresetDefinition` is the throwing variant for command handlers.
+ */
+export declare function findPresetDefinition(id: string | undefined): PresetDefinition | undefined;
+/** Throwing lookup: NOT_FOUND (exit 3) for unknown names. */
+export declare function requirePresetDefinition(id: string | undefined): PresetDefinition;
+/** A compact row for `presets list`, enriched with what each preset configures. */
+export interface PresetListRow {
+    id: string;
+    name: string;
+    command: string;
+    governance: PresetDescriptor["governance"];
+    idPrefix: string;
+    templates: string[];
+    templateCount: number;
+    /** Distinct built-in item types the templates create. */
+    itemTypes: string[];
+    /** Names of custom item types registered via the schema API. */
+    customItemTypes: string[];
+    description: string;
+}
+export declare function buildListRows(): PresetListRow[];
+/** One validation problem found in a bundled preset. */
+export interface PresetValidationIssue {
+    presetId: string;
+    message: string;
+}
+export interface PresetValidationResult {
+    ok: boolean;
+    checked: number;
+    issues: PresetValidationIssue[];
+}
+/**
+ * Validate that every bundled preset parses/loads coherently:
+ *  - registry descriptor and raw exports agree,
+ *  - governance is a known enum value,
+ *  - id_prefix is present,
+ *  - templates have valid names and string/string[] option values,
+ *  - the descriptor's advertised template list matches what is exported.
+ */
+export declare function validateAllPresets(): PresetValidationResult;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,mBAAmB,EAGpB,MAAM,qBAAqB,CAAC;AAiB7B,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,gEAAgE;IAChE,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,sCAAsC;IACtC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,sEAAsE;IACtE,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAiED,gDAAgD;AAChD,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAUzF;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAUhF;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gEAAgE;IAChE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,IAAI,aAAa,EAAE,CAkB/C;AAED,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAKD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,sBAAsB,CAsD3D"}

package/dist/catalog.js

@@ -0,0 +1,173 @@
+/**
+ * catalog.ts — structured, read-only views over the bundled presets.
+ *
+ * The individual preset modules export their SETTINGS / TEMPLATES (and, for
+ * kanban, ITEM_TYPES). This module joins those raw exports with the
+ * PRESET_REGISTRY descriptors and derives the higher-level views consumed by
+ * the read-only commands `presets show`, `presets diff`, and `presets validate`
+ * (plus the enriched `presets list`).
+ *
+ * Everything here is pure: no filesystem, no process exit, no SDK runtime. That
+ * keeps it unit-testable with `node --test` and side-effect free.
+ */
+import { CommandError, EXIT_CODE } from "./presets/shared.js";
+import { bugTriageSettings, bugTriageTemplates, indieDevSettings, indieDevTemplates, openSourceSettings, openSourceTemplates, softwareSprintSettings, softwareSprintTemplates, startupRoadmapSettings, startupRoadmapTemplates, kanbanSettings, kanbanTemplates, kanbanItemTypes, } from "./registry.js";
+import { PRESET_REGISTRY } from "./registry.js";
+/** Raw exports keyed by preset id. */
+const RAW_PRESETS = {
+    "bug-triage": { settings: bugTriageSettings, templates: bugTriageTemplates },
+    "indie-dev": { settings: indieDevSettings, templates: indieDevTemplates },
+    "open-source": { settings: openSourceSettings, templates: openSourceTemplates },
+    "software-sprint": { settings: softwareSprintSettings, templates: softwareSprintTemplates },
+    "startup-roadmap": { settings: startupRoadmapSettings, templates: startupRoadmapTemplates },
+    "kanban": { settings: kanbanSettings, templates: kanbanTemplates, itemTypes: kanbanItemTypes },
+};
+function templateView(document) {
+    const options = document.options;
+    const type = typeof options.type === "string" ? options.type : "Task";
+    const optionKeys = Object.keys(options).sort((left, right) => left.localeCompare(right));
+    return { name: document.name, type, optionKeys };
+}
+function itemTypeViews(raw) {
+    if (!raw.itemTypes) {
+        return [];
+    }
+    return raw.itemTypes.map((entry) => ({
+        name: entry.name,
+        aliases: Array.isArray(entry.aliases) ? [...entry.aliases] : [],
+        options: Array.isArray(entry.options)
+            ? entry.options.map((option) => ({
+                key: option.key,
+                values: Array.isArray(option.values) ? [...option.values] : [],
+            }))
+            : [],
+    }));
+}
+/** Build the full structured definition for a known descriptor. */
+function buildDefinition(descriptor) {
+    const raw = RAW_PRESETS[descriptor.id];
+    if (!raw) {
+        // Registry and raw exports are compile-time bound, so this is a guard for
+        // future drift rather than a runtime-reachable path.
+        throw new CommandError(`No definition exports for preset '${descriptor.id}'.`);
+    }
+    const templates = Object.values(raw.templates)
+        .map(templateView)
+        .sort((left, right) => left.name.localeCompare(right.name));
+    return {
+        id: descriptor.id,
+        displayName: descriptor.displayName,
+        description: descriptor.description,
+        command: descriptor.command,
+        idPrefix: descriptor.idPrefix,
+        governance: descriptor.governance,
+        settings: raw.settings,
+        templates,
+        itemTypes: itemTypeViews(raw),
+    };
+}
+/** All preset definitions in registry order. */
+export function listPresetDefinitions() {
+    return PRESET_REGISTRY.map(buildDefinition);
+}
+/**
+ * Find one preset definition by id (case-insensitive, trimmed).
+ *
+ * Returns `undefined` for unknown names so callers decide the error contract;
+ * `requirePresetDefinition` is the throwing variant for command handlers.
+ */
+export function findPresetDefinition(id) {
+    if (typeof id !== "string") {
+        return undefined;
+    }
+    const needle = id.trim().toLowerCase();
+    if (needle.length === 0) {
+        return undefined;
+    }
+    const descriptor = PRESET_REGISTRY.find((preset) => preset.id.toLowerCase() === needle);
+    return descriptor ? buildDefinition(descriptor) : undefined;
+}
+/** Throwing lookup: NOT_FOUND (exit 3) for unknown names. */
+export function requirePresetDefinition(id) {
+    const found = findPresetDefinition(id);
+    if (!found) {
+        const ids = PRESET_REGISTRY.map((preset) => preset.id).join(", ");
+        throw new CommandError(`Unknown preset '${id ?? ""}'. Available: ${ids}. Run \`pm presets list\` for details.`, EXIT_CODE.NOT_FOUND);
+    }
+    return found;
+}
+export function buildListRows() {
+    return listPresetDefinitions().map((definition) => {
+        const builtinTypes = [...new Set(definition.templates.map((template) => template.type))].sort((left, right) => left.localeCompare(right));
+        return {
+            id: definition.id,
+            name: definition.displayName,
+            command: definition.command,
+            governance: definition.governance,
+            idPrefix: definition.idPrefix,
+            templates: definition.templates.map((template) => template.name),
+            templateCount: definition.templates.length,
+            itemTypes: builtinTypes,
+            customItemTypes: definition.itemTypes.map((type) => type.name),
+            description: definition.description,
+        };
+    });
+}
+const GOVERNANCE_VALUES = new Set(["minimal", "default", "strict", "custom"]);
+const TEMPLATE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/**
+ * Validate that every bundled preset parses/loads coherently:
+ *  - registry descriptor and raw exports agree,
+ *  - governance is a known enum value,
+ *  - id_prefix is present,
+ *  - templates have valid names and string/string[] option values,
+ *  - the descriptor's advertised template list matches what is exported.
+ */
+export function validateAllPresets() {
+    const issues = [];
+    const definitions = listPresetDefinitions();
+    for (const definition of definitions) {
+        const add = (message) => issues.push({ presetId: definition.id, message });
+        if (!GOVERNANCE_VALUES.has(definition.governance)) {
+            add(`invalid governance '${definition.governance}'`);
+        }
+        if (typeof definition.idPrefix !== "string" || definition.idPrefix.length === 0) {
+            add("missing id_prefix");
+        }
+        if (typeof definition.settings.id_prefix !== "string" || definition.settings.id_prefix.length === 0) {
+            add("settings patch is missing id_prefix");
+        }
+        if (definition.templates.length === 0) {
+            add("has no templates");
+        }
+        const raw = RAW_PRESETS[definition.id];
+        for (const [filename, document] of Object.entries(raw.templates)) {
+            if (!TEMPLATE_NAME_PATTERN.test(document.name)) {
+                add(`template name '${document.name}' is invalid`);
+            }
+            if (filename !== `${document.name}.json`) {
+                add(`template map key '${filename}' does not match document name '${document.name}'`);
+            }
+            for (const [key, value] of Object.entries(document.options)) {
+                const validValue = typeof value === "string" ||
+                    (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
+                if (key.trim().length === 0) {
+                    add(`template '${document.name}' has an empty option key`);
+                }
+                if (!validValue) {
+                    add(`template '${document.name}' option '${key}' has a non-string value`);
+                }
+            }
+        }
+        // The registry descriptor advertises a template list; confirm it matches
+        // what the preset module actually exports (drift would mislead `list`).
+        const descriptor = PRESET_REGISTRY.find((preset) => preset.id === definition.id);
+        const advertised = [...(descriptor?.templates ?? [])].sort((a, b) => a.localeCompare(b));
+        const exported = definition.templates.map((template) => template.name).sort((a, b) => a.localeCompare(b));
+        if (JSON.stringify(advertised) !== JSON.stringify(exported)) {
+            add(`registry templates [${advertised.join(", ")}] differ from exported [${exported.join(", ")}]`);
+        }
+    }
+    return { ok: issues.length === 0, checked: definitions.length, issues };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,57 @@
+/**
+ * diff.ts — compare a pm workspace against a bundled preset definition.
+ *
+ * The comparison is split in two so the interesting logic stays pure and
+ * unit-testable:
+ *
+ *   - `computePresetDiff(definition, snapshot)` is pure: it takes an already-read
+ *     workspace snapshot and the preset definition and returns a structured diff.
+ *   - `readWorkspaceSnapshot(pmDir)` is the only filesystem-touching part.
+ *
+ * What we compare:
+ *   - settings.json: every leaf in the preset's settings patch (added vs changed
+ *     vs already-matching),
+ *   - templates: which of the preset's templates are missing / present in the
+ *     workspace `templates/` directory,
+ *   - item types: the custom item types the preset registers (informational —
+ *     they are registered in-memory at activation, not written to disk).
+ */
+import type { PresetDefinition } from "./catalog.js";
+type JsonValue = unknown;
+type JsonObject = Record<string, unknown>;
+export interface WorkspaceSnapshot {
+    /** Parsed settings.json (or `undefined` if absent/unreadable). */
+    settings: JsonObject | undefined;
+    /** Template names present in the workspace `templates/` directory. */
+    templateNames: string[];
+}
+export interface SettingDiffEntry {
+    /** Dotted path into settings.json, e.g. "governance.preset". */
+    path: string;
+    status: "add" | "change" | "match";
+    preset: JsonValue;
+    workspace: JsonValue;
+}
+export interface PresetDiff {
+    presetId: string;
+    /** True when applying the preset would change nothing. */
+    inSync: boolean;
+    settings: SettingDiffEntry[];
+    templates: {
+        missing: string[];
+        present: string[];
+    };
+    /** Custom item types the preset would register (informational). */
+    itemTypes: string[];
+    summary: {
+        settingsToAdd: number;
+        settingsToChange: number;
+        templatesMissing: number;
+    };
+}
+/** Pure diff: preset definition vs an already-read workspace snapshot. */
+export declare function computePresetDiff(definition: PresetDefinition, snapshot: WorkspaceSnapshot): PresetDiff;
+/** Read the workspace snapshot from disk (the only impure part). */
+export declare function readWorkspaceSnapshot(pmDir: string): WorkspaceSnapshot;
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,KAAK,SAAS,GAAG,OAAO,CAAC;AACzB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,sEAAsE;IACtE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,mEAAmE;IACnE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAuCD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,iBAAiB,GAC1B,UAAU,CAyCZ;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAwBtE"}

package/dist/diff.js

@@ -0,0 +1,120 @@
+/**
+ * diff.ts — compare a pm workspace against a bundled preset definition.
+ *
+ * The comparison is split in two so the interesting logic stays pure and
+ * unit-testable:
+ *
+ *   - `computePresetDiff(definition, snapshot)` is pure: it takes an already-read
+ *     workspace snapshot and the preset definition and returns a structured diff.
+ *   - `readWorkspaceSnapshot(pmDir)` is the only filesystem-touching part.
+ *
+ * What we compare:
+ *   - settings.json: every leaf in the preset's settings patch (added vs changed
+ *     vs already-matching),
+ *   - templates: which of the preset's templates are missing / present in the
+ *     workspace `templates/` directory,
+ *   - item types: the custom item types the preset registers (informational —
+ *     they are registered in-memory at activation, not written to disk).
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Flatten a settings patch into dotted-path leaves, recursing into objects. */
+function flattenLeaves(value, prefix = "") {
+    const leaves = [];
+    for (const [key, child] of Object.entries(value)) {
+        const dotted = prefix ? `${prefix}.${key}` : key;
+        if (isJsonObject(child)) {
+            leaves.push(...flattenLeaves(child, dotted));
+        }
+        else {
+            leaves.push({ path: dotted, value: child });
+        }
+    }
+    return leaves;
+}
+/** Read a dotted path out of a JSON object; returns `undefined` if any hop misses. */
+function readPath(root, dotted) {
+    if (!root) {
+        return { found: false, value: undefined };
+    }
+    let current = root;
+    for (const segment of dotted.split(".")) {
+        if (!isJsonObject(current) || !Object.prototype.hasOwnProperty.call(current, segment)) {
+            return { found: false, value: undefined };
+        }
+        current = current[segment];
+    }
+    return { found: true, value: current };
+}
+function valuesEqual(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+/** Pure diff: preset definition vs an already-read workspace snapshot. */
+export function computePresetDiff(definition, snapshot) {
+    const presetSettings = definition.settings;
+    const settingLeaves = flattenLeaves(presetSettings);
+    const settings = settingLeaves.map((leaf) => {
+        const current = readPath(snapshot.settings, leaf.path);
+        if (!current.found) {
+            return { path: leaf.path, status: "add", preset: leaf.value, workspace: undefined };
+        }
+        if (valuesEqual(current.value, leaf.value)) {
+            return { path: leaf.path, status: "match", preset: leaf.value, workspace: current.value };
+        }
+        return { path: leaf.path, status: "change", preset: leaf.value, workspace: current.value };
+    });
+    const workspaceTemplates = new Set(snapshot.templateNames);
+    const missing = [];
+    const present = [];
+    for (const template of definition.templates) {
+        if (workspaceTemplates.has(template.name)) {
+            present.push(template.name);
+        }
+        else {
+            missing.push(template.name);
+        }
+    }
+    const settingsToAdd = settings.filter((entry) => entry.status === "add").length;
+    const settingsToChange = settings.filter((entry) => entry.status === "change").length;
+    return {
+        presetId: definition.id,
+        inSync: settingsToAdd === 0 && settingsToChange === 0 && missing.length === 0,
+        settings,
+        templates: { missing, present },
+        itemTypes: definition.itemTypes.map((type) => type.name),
+        summary: {
+            settingsToAdd,
+            settingsToChange,
+            templatesMissing: missing.length,
+        },
+    };
+}
+/** Read the workspace snapshot from disk (the only impure part). */
+export function readWorkspaceSnapshot(pmDir) {
+    const settingsPath = path.join(pmDir, "settings.json");
+    let settings;
+    if (fs.existsSync(settingsPath)) {
+        try {
+            const parsed = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+            if (isJsonObject(parsed)) {
+                settings = parsed;
+            }
+        }
+        catch {
+            settings = undefined;
+        }
+    }
+    const templatesDir = path.join(pmDir, "templates");
+    let templateNames = [];
+    if (fs.existsSync(templatesDir)) {
+        templateNames = fs
+            .readdirSync(templatesDir)
+            .filter((entry) => entry.toLowerCase().endsWith(".json"))
+            .map((entry) => entry.slice(0, -".json".length));
+    }
+    return { settings, templateNames };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/index.d.ts

@@ -12,6 +12,13 @@
  *   pm oss-setup         # open-source preset
  *   pm sprint-setup      # software-sprint preset
  *   pm roadmap-setup     # startup-roadmap preset
+ *
+ * Plus a unified, read-only management surface:
+ *   pm presets list                 # enumerate presets + what each configures
+ *   pm presets show <id>            # full definition of one preset
+ *   pm presets diff <id>            # workspace vs preset differences
+ *   pm presets validate             # validate all bundled presets parse/load
+ *   pm presets apply <id>           # scaffold a preset into this workspace
  */
 declare const _default: {
     activate(api: import("@unbrained/pm-cli/sdk").ExtensionApi): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;;AAgEH,wBA4IG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;AA2FH,wBA2NG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -12,15 +12,25 @@
  *   pm oss-setup         # open-source preset
  *   pm sprint-setup      # software-sprint preset
  *   pm roadmap-setup     # startup-roadmap preset
+ *
+ * Plus a unified, read-only management surface:
+ *   pm presets list                 # enumerate presets + what each configures
+ *   pm presets show <id>            # full definition of one preset
+ *   pm presets diff <id>            # workspace vs preset differences
+ *   pm presets validate             # validate all bundled presets parse/load
+ *   pm presets apply <id>           # scaffold a preset into this workspace
  */
 import { runBugTriageSetup } from "./presets/bug-triage/index.js";
 import { runIndieDevSetup } from "./presets/indie-dev/index.js";
 import { runKanbanSetup, ITEM_TYPES as kanbanItemTypes } from "./presets/kanban/index.js";
 import { runOpenSourceSetup } from "./presets/open-source/index.js";
-import { runTemplatesList, runTemplatesShow } from "./presets/shared.js";
+import { resolvePmDir, readBooleanOption, runTemplatesList, runTemplatesShow } from "./presets/shared.js";
 import { runSoftwareSprintSetup } from "./presets/software-sprint/index.js";
 import { runStartupRoadmapSetup } from "./presets/startup-roadmap/index.js";
 import { PRESET_REGISTRY } from "./registry.js";
+import { buildListRows, requirePresetDefinition, validateAllPresets, } from "./catalog.js";
+import { computePresetDiff, readWorkspaceSnapshot } from "./diff.js";
+import { planSeeds, seedPresetItems, seedsForPreset } from "./seeds.js";
 const defineExtension = ((extension) => extension);
 // A thrown error only yields a clean non-zero exit (no double-invocation) when
 // it carries a numeric `exitCode`. Standalone-installed extensions can't import
@@ -68,6 +78,24 @@ const COMMON_FLAGS = [
         description: "Override the id_prefix written to settings.json.",
     },
 ];
+// `presets apply` additionally accepts --with-seeds to create starter items.
+const APPLY_FLAGS = [
+    ...COMMON_FLAGS,
+    {
+        long: "--with-seeds",
+        short: "-s",
+        type: "boolean",
+        description: "Also create the preset's starter items (built-in fields only; see #97).",
+    },
+];
+// `presets list`/`show`/`diff`/`validate` are read-only and JSON-friendly.
+const JSON_FLAG = [
+    {
+        long: "--json",
+        type: "boolean",
+        description: "Emit machine-readable JSON instead of the human summary.",
+    },
+];
 export default defineExtension({
     activate(api) {
         // ── bug-triage ──────────────────────────────────────────────────────────
@@ -116,24 +144,61 @@ export default defineExtension({
         if (typeof api.registerItemTypes === "function") {
             api.registerItemTypes(kanbanItemTypes);
         }
-        // ── unified presets list / apply ────────────────────────────────────────
+        // ── unified presets list / show / diff / validate / apply ────────────────
         api.registerCommand({
             name: "presets list",
             action: "presets-list",
-            description: "List all available workspace presets bundled in pm-presets.",
-            examples: ["pm presets list"],
+            description: "List all bundled workspace presets with what each configures (governance, item types, templates).",
+            examples: ["pm presets list", "pm presets list --json"],
+            flags: JSON_FLAG,
             run: () => ({
-                presets: PRESET_REGISTRY.map((p) => ({
-                    id: p.id,
-                    name: p.displayName,
-                    command: p.command,
-                    governance: p.governance,
-                    templates: p.templates,
-                    description: p.description,
-                })),
+                presets: buildListRows(),
                 count: PRESET_REGISTRY.length,
             }),
         });
+        api.registerCommand({
+            name: "presets show",
+            action: "presets-show",
+            description: "Print the full definition of one preset: settings patch, templates, and custom item types.",
+            examples: ["pm presets show software-sprint", "pm presets show kanban --json"],
+            arguments: [
+                { name: "preset", required: true, description: "Preset id (see `pm presets list`)." },
+            ],
+            flags: JSON_FLAG,
+            run: (ctx) => requirePresetDefinition(ctx.args?.[0]),
+        });
+        api.registerCommand({
+            name: "presets diff",
+            action: "presets-diff",
+            description: "Compare the current pm workspace (settings + installed templates) against a preset and report differences.",
+            examples: ["pm presets diff software-sprint", "pm presets diff bug-triage --json"],
+            arguments: [
+                { name: "preset", required: true, description: "Preset id (see `pm presets list`)." },
+            ],
+            flags: JSON_FLAG,
+            run: (ctx) => {
+                const definition = requirePresetDefinition(ctx.args?.[0]);
+                const snapshot = readWorkspaceSnapshot(resolvePmDir(ctx));
+                return computePresetDiff(definition, snapshot);
+            },
+        });
+        api.registerCommand({
+            name: "presets validate",
+            action: "presets-validate",
+            description: "Validate that all bundled presets parse and load correctly.",
+            examples: ["pm presets validate", "pm presets validate --json"],
+            flags: JSON_FLAG,
+            run: () => {
+                const result = validateAllPresets();
+                if (!result.ok) {
+                    const detail = result.issues
+                        .map((issue) => `  ${issue.presetId}: ${issue.message}`)
+                        .join("\n");
+                    throw new PresetError(`${result.issues.length} preset validation issue(s) across ${result.checked} preset(s):\n${detail}`, 1);
+                }
+                return result;
+            },
+        });
         api.registerCommand({
             name: "presets apply",
             action: "presets-apply",
@@ -141,20 +206,52 @@ export default defineExtension({
             examples: [
                 "pm presets apply kanban",
                 "pm presets apply software-sprint --dry-run",
+                "pm presets apply bug-triage --with-seeds",
                 "pm presets apply bug-triage --force",
             ],
             arguments: [
                 { name: "preset", required: true, description: "Preset id (see `pm presets list`)." },
             ],
-            flags: COMMON_FLAGS,
+            flags: APPLY_FLAGS,
             run: (ctx) => {
                 const id = ctx.args?.[0];
-                const handler = id ? PRESET_HANDLERS[id] : undefined;
-                if (!handler) {
-                    const ids = Object.keys(PRESET_HANDLERS).join(", ");
-                    throw new PresetError(`Unknown preset '${id ?? ""}'. Available: ${ids}. Run \`pm presets list\` for details.`, 2);
+                // Validate the id up front (NOT_FOUND/exit 3 for unknown names).
+                const definition = requirePresetDefinition(id);
+                const handler = PRESET_HANDLERS[definition.id];
+                handler(ctx);
+                const withSeeds = readBooleanOption(ctx.options, "withSeeds", "with-seeds");
+                if (!withSeeds) {
+                    return;
+                }
+                const dryRun = readBooleanOption(ctx.options, "dryRun", "dry-run");
+                const pmRoot = resolvePmDir(ctx);
+                const seeds = seedsForPreset(definition.id);
+                if (seeds.length === 0) {
+                    console.log(`No starter seeds defined for '${definition.id}'.`);
+                    return;
+                }
+                if (dryRun) {
+                    console.log("");
+                    console.log(`[dry-run] Would seed ${seeds.length} starter item(s):`);
+                    for (const entry of planSeeds(pmRoot, definition.id)) {
+                        console.log(`  - ${entry.type}: ${entry.title}`);
+                    }
+                    return;
+                }
+                console.log("");
+                console.log(`Seeding ${seeds.length} starter item(s)...`);
+                const seedResult = seedPresetItems(pmRoot, definition.id);
+                for (const detail of seedResult.details) {
+                    if (detail.ok) {
+                        console.log(`  Created: ${detail.title}`);
+                    }
+                    else {
+                        console.warn(`  Failed:  ${detail.title}${detail.message ? ` (${detail.message})` : ""}`);
+                    }
+                }
+                if (seedResult.failed > 0) {
+                    throw new PresetError(`Seeded ${seedResult.created} item(s) but ${seedResult.failed} failed.`, 1);
                 }
-                return handler(ctx);
             },
         });
         // ── create-template runtime ─────────────────────────────────────────────

package/dist/index.js.map

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

package/dist/seeds.d.ts

@@ -0,0 +1,48 @@
+/**
+ * seeds.ts — optional starter items for `presets apply <id> --with-seeds`.
+ *
+ * IMPORTANT (pm-cli issue #97): custom scalar fields registered via
+ * `registerItemFields` have no `pm create --<field>` setter. Seed items
+ * therefore set ONLY built-in fields (title, type, priority, tags, body). Any
+ * preset-specific context lives in the body text, not in custom options.
+ *
+ * Seeding shells out to the `pm` binary so item IDs, the toon format, and
+ * workspace governance are all handled by pm itself rather than re-implemented
+ * here. The seed *definitions* and the dry-run plan are pure and unit-tested;
+ * only `seedPresetItems` touches the process.
+ */
+/** A single starter item, restricted to built-in create fields. */
+export interface SeedItem {
+    type: string;
+    title: string;
+    priority?: string;
+    tags?: string;
+    body?: string;
+}
+/** Built-in-only seed items keyed by preset id. */
+export declare const PRESET_SEEDS: Record<string, SeedItem[]>;
+export declare function seedsForPreset(presetId: string): SeedItem[];
+/** Build the `pm create` argv for one seed item (built-in fields only). */
+export declare function buildSeedCreateArgs(pmRoot: string, seed: SeedItem): string[];
+export interface SeedPlanEntry {
+    title: string;
+    type: string;
+    command: string;
+}
+/** Pure dry-run plan: what `--with-seeds` would create, without running anything. */
+export declare function planSeeds(pmRoot: string, presetId: string): SeedPlanEntry[];
+export interface SeedResult {
+    created: number;
+    failed: number;
+    details: Array<{
+        title: string;
+        ok: boolean;
+        message?: string;
+    }>;
+}
+/**
+ * Create the preset's starter items by shelling out to `pm create`.
+ * Non-throwing: failures are collected so a partial seed still reports clearly.
+ */
+export declare function seedPresetItems(pmRoot: string, presetId: string, pmBin?: string): SeedResult;
+//# sourceMappingURL=seeds.d.ts.map

package/dist/seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../src/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mDAAmD;AACnD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CA8DnD,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAE3D;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAY5E;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAM3E;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,UAAU,CAwB1F"}

package/dist/seeds.js

@@ -0,0 +1,132 @@
+/**
+ * seeds.ts — optional starter items for `presets apply <id> --with-seeds`.
+ *
+ * IMPORTANT (pm-cli issue #97): custom scalar fields registered via
+ * `registerItemFields` have no `pm create --<field>` setter. Seed items
+ * therefore set ONLY built-in fields (title, type, priority, tags, body). Any
+ * preset-specific context lives in the body text, not in custom options.
+ *
+ * Seeding shells out to the `pm` binary so item IDs, the toon format, and
+ * workspace governance are all handled by pm itself rather than re-implemented
+ * here. The seed *definitions* and the dry-run plan are pure and unit-tested;
+ * only `seedPresetItems` touches the process.
+ */
+import { spawnSync } from "node:child_process";
+/** Built-in-only seed items keyed by preset id. */
+export const PRESET_SEEDS = {
+    "bug-triage": [
+        {
+            type: "Issue",
+            title: "Example production incident",
+            priority: "1",
+            tags: "incident,production",
+            body: "Starter incident seeded by pm-presets. Replace with a real incident.",
+        },
+    ],
+    "indie-dev": [
+        {
+            type: "Task",
+            title: "Set up project skeleton",
+            priority: "2",
+            tags: "task",
+            body: "Starter task seeded by pm-presets.",
+        },
+    ],
+    "open-source": [
+        {
+            type: "Issue",
+            title: "Triage incoming community issues",
+            priority: "2",
+            tags: "triage",
+            body: "Starter triage issue seeded by pm-presets.",
+        },
+    ],
+    "software-sprint": [
+        {
+            type: "Epic",
+            title: "First sprint epic",
+            priority: "2",
+            tags: "epic,sprint",
+            body: "Starter epic seeded by pm-presets.",
+        },
+        {
+            type: "Task",
+            title: "First sprint task",
+            priority: "2",
+            tags: "task,sprint",
+            body: "Starter task seeded by pm-presets.",
+        },
+    ],
+    "startup-roadmap": [
+        {
+            type: "Feature",
+            title: "Define first roadmap initiative",
+            priority: "2",
+            tags: "roadmap",
+            body: "Starter initiative seeded by pm-presets.",
+        },
+    ],
+    "kanban": [
+        {
+            type: "Card",
+            title: "First card on the board",
+            priority: "2",
+            tags: "kanban",
+            body: "Starter card seeded by pm-presets.",
+        },
+    ],
+};
+export function seedsForPreset(presetId) {
+    return PRESET_SEEDS[presetId] ?? [];
+}
+/** Build the `pm create` argv for one seed item (built-in fields only). */
+export function buildSeedCreateArgs(pmRoot, seed) {
+    const args = ["--path", pmRoot, "create", "--type", seed.type, "--title", seed.title];
+    if (seed.priority) {
+        args.push("--priority", seed.priority);
+    }
+    if (seed.tags) {
+        args.push("--tags", seed.tags);
+    }
+    if (seed.body) {
+        args.push("--body", seed.body);
+    }
+    return args;
+}
+/** Pure dry-run plan: what `--with-seeds` would create, without running anything. */
+export function planSeeds(pmRoot, presetId) {
+    return seedsForPreset(presetId).map((seed) => ({
+        title: seed.title,
+        type: seed.type,
+        command: `pm ${buildSeedCreateArgs(pmRoot, seed).join(" ")}`,
+    }));
+}
+/**
+ * Create the preset's starter items by shelling out to `pm create`.
+ * Non-throwing: failures are collected so a partial seed still reports clearly.
+ */
+export function seedPresetItems(pmRoot, presetId, pmBin = "pm") {
+    const seeds = seedsForPreset(presetId);
+    const details = [];
+    let created = 0;
+    let failed = 0;
+    for (const seed of seeds) {
+        const result = spawnSync(pmBin, buildSeedCreateArgs(pmRoot, seed), {
+            encoding: "utf8",
+        });
+        if (result.status === 0) {
+            created += 1;
+            details.push({ title: seed.title, ok: true });
+        }
+        else {
+            failed += 1;
+            const message = (result.stderr || result.stdout || result.error?.message || "")
+                .toString()
+                .trim()
+                .split("\n")[0];
+            details.push({ title: seed.title, ok: false, message });
+        }
+    }
+    return { created, failed, details };
+}
+//# sourceMappingURL=seeds.js.map

package/dist/seeds.js.map

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

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-presets",
-  "version": "2026.6.2",
+  "version": "2026.6.3-1",
   "description": "All 5 official pm-cli workspace presets in one package: bug-triage, indie-dev, open-source, software-sprint, startup-roadmap",
   "author": "@unbraind",
   "entry": "./dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-presets",
-  "version": "2026.6.2",
+  "version": "2026.6.3-1",
   "description": "All 5 official pm-cli workspace presets in one package: bug-triage, indie-dev, open-source, software-sprint, startup-roadmap",
   "repository": {
     "type": "git",
@@ -34,7 +34,7 @@
     "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
     "check": "npm run typecheck",
-    "test": "node --test --experimental-strip-types tests/registry.test.ts",
+    "test": "node --test --experimental-strip-types tests/registry.test.ts tests/catalog.test.ts tests/diff.test.ts tests/seeds.test.ts",
     "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-presets/blob/main/.agents/pm",
@@ -43,12 +43,12 @@
     "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.29"
+    "@unbrained/pm-cli": ">=2026.5.31"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
     "@unbrained/pm-cli": "^2026.5.31",
-    "pm-changelog": "^2026.5.29-2",
+    "pm-changelog": "^2026.6.2",
     "typescript": "^6.0.3"
   },
   "engines": {