pm-presets 2026.10.20 → 2026.10.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,26 @@
1
1
  # Changelog
2
2
 
3
+ ## 2026.10.23 - 2026-10-23
4
+
5
+ ### Changed
6
+
7
+ - Enable the gated GitHub issue sync ([pm-1631](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/chores/pm-1631.toon))
8
+ - Adopt pm-github 2026.10.16: default-branch-safe gated sync and daily gated closeout PRs ([pm-1ugy](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/chores/pm-1ugy.toon))
9
+
10
+ ### Fixed
11
+
12
+ - Propagate the docstring gate entry guard fix ([pm-wqll](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-wqll.toon))
13
+ - Fix release publish ordering before protected main push ([pm-g33z](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-g33z.toon))
14
+ - The publish-attestation gate misses a publish routed through an unquoted shell variable ([pm-mzg9](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-mzg9.toon))
15
+ - Preset apply bypasses workspace settings history and leaves strict health failing ([pm-1vx6](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-1vx6.toon))
16
+ - Keep weekly toolchain bumps compatible with audited preset replacement and prepare behavior ([pm-0czt](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-0czt.toon))
17
+ - The release job authenticated with a stored npm token that expired, so publishing stopped while every other gate stayed green ([pm-6e1a](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-6e1a.toon))
18
+ - A release run bumped and committed a new version every night while publishing was impossible, because the only externally-failable step runs last ([pm-nhcz](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/issues/pm-nhcz.toon))
19
+
20
+ ### Other
21
+
22
+ - Certify pm-presets on PM CLI SDK 2026.9.28 and current published release helpers ([pm-weky](https://github.com/unbraind/pm-presets/blob/main/.agents/pm/chores/pm-weky.toon))
23
+
3
24
  ## 2026.10.12 - 2026-10-12
4
25
 
5
26
  ### Fixed
package/README.md CHANGED
@@ -300,6 +300,51 @@ host resets to defaults or preset policy, without printing their old values.
300
300
  Templates are separate filesystem writes after the audited settings commit;
301
301
  a later filesystem failure does not roll back that committed settings event.
302
302
 
303
+ ## Simulate before applying
304
+
305
+ Run representative agent workflows before changing your workspace:
306
+
307
+ ```bash
308
+ pm presets simulate bug-triage
309
+ pm presets simulate indie-dev --json
310
+ pm presets simulate software-sprint --scenarios create-task,claim-start --json
311
+ ```
312
+
313
+ Suite version 1 applies the same bundled setup handler as `presets apply`, then
314
+ executes four workflows with the real local pm SDK:
315
+
316
+ | Scenario | Declared result |
317
+ | --- | --- |
318
+ | `create-task` | Task exists and is open |
319
+ | `claim-start` | Claimed Task is in progress |
320
+ | `close-without-evidence` | Refused for bug-triage; closed for other bundled presets |
321
+ | `close-with-evidence` | Closed with resolution, expected and actual result |
322
+
323
+ Expected governance refusals count as passing observations. Every report includes
324
+ expected and actual states, pass counts, omitted scenario IDs in `coverageGaps`,
325
+ and scope limitations. Selecting a subset does **not** establish full coverage.
326
+ Exit 4 means a mismatch or coverage gap; the report is printed before the error.
327
+ Unknown presets/scenarios and duplicate selections produce typed usage refusals
328
+ (exit 2) with remedies. Missing SDK support or worker failure uses exit 1.
329
+
330
+ The simulator accepts bundled IDs and scenario IDs only. It creates a new tracker
331
+ and home directory in a separate process, disables extension loading and telemetry,
332
+ and supplies no tracker paths, credentials, scripts or caller configuration to it.
333
+ It never installs into, reads, or writes the caller's tracker. Scratch files are
334
+ removed after success or failure. The CLI host may perform its normal runtime
335
+ bookkeeping before invoking an extension command.
336
+
337
+ Reports are reproducible for the same package, suite and supported host version:
338
+ random item IDs, timestamps, paths, durations and free-form SDK diagnostics are
339
+ excluded. Scenarios run in canonical order and each creates its own Task.
340
+ The bounded suite checks built-in Task lifecycle behavior; installed templates,
341
+ custom types, external integrations and real agent inference remain explicit
342
+ limitations. A passing simulation is not approval to apply a preset or a forecast
343
+ of your workspace's existing policies.
344
+
345
+ See [the SDK example](docs/simulation-example.md), including partial coverage and
346
+ handling typed refusals.
347
+
303
348
  ## Programmatic API
304
349
 
305
350
  ```typescript
@@ -329,7 +374,31 @@ After merging a branch that touched `.agents/pm/`, reconcile any residual histor
329
374
  **`pm merge reconcile`**: preview with `pm merge reconcile --dry-run`, apply with
330
375
  `pm merge reconcile --message "post-merge reconcile"`, then confirm with `pm validate`, which scans the
331
376
  whole tracker and flags remaining history drift across **every** affected item (`pm merge reconcile`
332
- itself lists each affected stream in its output; `pm history --verify <id>` spot-checks one item). The field-aware driver already unions every author's
333
- content, so `reconcile` only re-greens the hash chain (no data loss) — see the authoritative
334
- [pm-cli merge-safety guide](https://github.com/unbraind/pm-cli/blob/main/docs/MERGE_SAFETY.md). The
335
- older blunt `pm history-repair --all` remains available as a lower-level primitive.
377
+ itself lists each affected stream in its output; `pm history --verify <id>` spot-checks one item).
378
+ Reconciliation repairs receipts and history consistency; a successful validation does not
379
+ prove that every concurrent edit survived. Inspect the merged item values and merge receipts
380
+ before accepting the result. Keep existing history append-only; do not use history rewriting
381
+ as a substitute for reconciliation. See the authoritative
382
+ [pm-cli merge-safety guide](https://github.com/unbraind/pm-cli/blob/main/docs/MERGE_SAFETY.md).
383
+
384
+ ## Without git
385
+
386
+ Preset listing, inspection, diff, validation, export, application, templates and
387
+ simulation work in plain directories as well as repositories. Simulation always
388
+ uses a disposable non-git tracker, with no git executable on its PATH. None of
389
+ these commands requires a Git repository. Upgrade planning, applying, retries and
390
+ rollback also work without git; they use the host SDK settings lock and history.
391
+
392
+ ## Versioned preset upgrades
393
+
394
+ `pm presets upgrade plan --from vendor-v1.json --to vendor-v2.json --receipt upgrade.private.json`
395
+ compares two `{id, version, settings}` vendor patches with the current workspace.
396
+ It preserves local-only edits and requires explicit JSON-pointer decisions when
397
+ vendor and local changes conflict. `presets upgrade apply <receipt>` and
398
+ `presets upgrade rollback <receipt>` use the host's audited settings API, including
399
+ idempotent retries and stale-settings checks. Plans and command results use
400
+ compact TOON or `--json`; complete recovery settings remain in a private receipt.
401
+ Requires canonical SDK previews (host 2026.10.17+).
402
+
403
+ See the [complete upgrade example](docs/upgrade-example.md) for decisions,
404
+ recovery, typed SDK usage, refusal remedies and migration boundaries.
package/dist/index.d.ts CHANGED
@@ -29,4 +29,8 @@ declare const _default: {
29
29
  export default _default;
30
30
  export { PRESET_REGISTRY } from "./registry.ts";
31
31
  export type { PresetDescriptor } from "./registry.ts";
32
+ export { simulatePreset, SimulationRefusal, PRESET_SCENARIOS } from "./simulation.ts";
33
+ export type { PresetSimulationOptions, PresetSimulationReport, PresetScenarioId, PresetScenarioResult, SimulationRefusalCode } from "./simulation.ts";
34
+ export { comparePresetUpgrade, planPresetUpgrade, executePresetUpgrade, parseUpgradeReceipt, summarizePresetUpgrade, UpgradeRefusal } from "./upgrade.ts";
35
+ export type { VersionedPreset, UpgradeSettings, UpgradeValue, UpgradeDecisions, UpgradeChange, PresetUpgradeReceipt, PresetUpgradeSummary, PresetUpgradeResult, UpgradeRefusalCode } from "./upgrade.ts";
32
36
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,iCAAiC,CAAC;;kBA+LrF,YAAY;;;AAyX5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,iCAAiC,CAAC;;kBAgLrF,YAAY;;;AA+Y5B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtF,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEtJ,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1J,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
package/dist/index.js CHANGED
@@ -31,11 +31,14 @@ import { resolvePmDir, readBooleanOption, readStringOption, runTemplatesList, ru
31
31
  import { runSoftwareSprintSetup } from "./presets/software-sprint/index.js";
32
32
  import { runStartupRoadmapSetup } from "./presets/startup-roadmap/index.js";
33
33
  import { PRESET_REGISTRY } from "./registry.js";
34
+ import { registerUpgradeCommands } from "./upgrade-command.js";
34
35
  import { buildListRows, requirePresetDefinition, requireValidPresets, validateAllPresets, } from "./catalog.js";
35
36
  import { computePresetDiff, readWorkspaceSnapshot } from "./diff.js";
36
37
  import { buildExportedPreset, readWorkspaceSettings, readWorkspaceTemplates, } from "./export.js";
37
38
  import { runPresetSeeds } from "./seeds.js";
38
39
  import * as fs from "node:fs";
40
+ import { PRESET_HANDLERS } from "./setup.js";
41
+ import { simulatePreset } from "./simulation.js";
39
42
  // Drift exit code for `presets diff --strict`. Distinct from GENERIC(1)/
40
43
  // USAGE(2)/NOT_FOUND(3) so CI can tell "drifted" from "command failed".
41
44
  const EXIT_CODE_DRIFT = 4;
@@ -54,23 +57,6 @@ class PresetError extends Error {
54
57
  this.exitCode = exitCode;
55
58
  }
56
59
  }
57
- // Dispatch table: preset id -> its setup handler. Powers `presets apply <id>`
58
- // and keeps the individual *-setup commands as thin aliases.
59
- //
60
- // Keyed on the closed `PresetId` union rather than `string`, so a preset added
61
- // to the registry without a handler here — or a handler for an id that does not
62
- // exist — fails the build instead of surfacing as a runtime "unknown preset".
63
- // The handlers apply settings and templates for their side effects and return
64
- // nothing, so the value type is `void`, not `unknown`.
65
- const PRESET_HANDLERS = {
66
- "bug-triage": runBugTriageSetup,
67
- "indie-dev": runIndieDevSetup,
68
- "open-source": runOpenSourceSetup,
69
- "software-sprint": runSoftwareSprintSetup,
70
- "startup-roadmap": runStartupRoadmapSetup,
71
- "kanban": runKanbanSetup,
72
- "agent-workflow": runAgentWorkflowSetup,
73
- };
74
60
  // pm-cli's loose-option matcher (extension-command-options.ts) only recognizes
75
61
  // flag definitions whose `long`/`short` include their dash prefixes. Declaring
76
62
  // `long: "dry-run"` (no `--`) makes the flag invisible to `--help` AND rejected
@@ -188,6 +174,7 @@ const PRESETS_FLAGS = [
188
174
  const defineExtension = (module) => module;
189
175
  export default defineExtension({
190
176
  activate(api) {
177
+ registerUpgradeCommands(api);
191
178
  // ── bug-triage ──────────────────────────────────────────────────────────
192
179
  api.registerCommand({
193
180
  name: "triage-setup",
@@ -439,6 +426,26 @@ export default defineExtension({
439
426
  examples: ["pm presets validate", "pm presets validate --json"],
440
427
  run: () => requireValidPresets(validateAllPresets()),
441
428
  });
429
+ api.registerCommand({
430
+ name: "presets simulate",
431
+ action: "presets-simulate",
432
+ description: "Execute reproducible agent workflows in an isolated synthetic tracker before applying a preset.",
433
+ examples: ["pm presets simulate bug-triage", "pm presets simulate indie-dev --json"],
434
+ arguments: [{ name: "preset", required: true, description: "Bundled preset id." }],
435
+ flags: [{ long: "--scenarios", value_name: "<ids>", value_type: "string", description: "Comma-separated scenario ids; omitted workflows are explicit coverage gaps." }],
436
+ run: (ctx) => {
437
+ const selection = ctx.options?.["scenarios"];
438
+ const report = simulatePreset({
439
+ preset: ctx.args?.[0] ?? "",
440
+ scenarios: typeof selection === "string" ? selection.split(",").map((id) => id.trim()).filter(Boolean) : undefined,
441
+ });
442
+ if (!report.ok) {
443
+ console.log(JSON.stringify(report));
444
+ throw new PresetError("Simulation has mismatches or coverage gaps; run the complete suite and inspect the observations.", 4);
445
+ }
446
+ return report;
447
+ },
448
+ });
442
449
  api.registerCommand({
443
450
  name: "presets apply",
444
451
  action: "presets-apply",
@@ -501,4 +508,6 @@ export default defineExtension({
501
508
  });
502
509
  // Re-export public API
503
510
  export { PRESET_REGISTRY } from "./registry.js";
511
+ export { simulatePreset, SimulationRefusal, PRESET_SCENARIOS } from "./simulation.js";
512
+ export { comparePresetUpgrade, planPresetUpgrade, executePresetUpgrade, parseUpgradeReceipt, summarizePresetUpgrade, UpgradeRefusal } from "./upgrade.js";
504
513
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /** Shared dispatch used by actual installation and disposable simulations. */
2
+ import type { CommandHandlerContext } from "@unbrained/pm-cli/sdk";
3
+ import type { PresetId } from "./registry.ts";
4
+ /** Complete setup handlers, keyed by the closed bundled-preset union. */
5
+ export declare const PRESET_HANDLERS: Record<PresetId, (ctx: CommandHandlerContext) => Promise<void>>;
6
+ //# sourceMappingURL=setup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAS9C,yEAAyE;AACzE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ3F,CAAC"}
package/dist/setup.js ADDED
@@ -0,0 +1,18 @@
1
+ import { runBugTriageSetup } from "./presets/bug-triage/index.js";
2
+ import { runIndieDevSetup } from "./presets/indie-dev/index.js";
3
+ import { runOpenSourceSetup } from "./presets/open-source/index.js";
4
+ import { runSoftwareSprintSetup } from "./presets/software-sprint/index.js";
5
+ import { runStartupRoadmapSetup } from "./presets/startup-roadmap/index.js";
6
+ import { runKanbanSetup } from "./presets/kanban/index.js";
7
+ import { runAgentWorkflowSetup } from "./presets/agent-workflow/index.js";
8
+ /** Complete setup handlers, keyed by the closed bundled-preset union. */
9
+ export const PRESET_HANDLERS = {
10
+ "bug-triage": runBugTriageSetup,
11
+ "indie-dev": runIndieDevSetup,
12
+ "open-source": runOpenSourceSetup,
13
+ "software-sprint": runSoftwareSprintSetup,
14
+ "startup-roadmap": runStartupRoadmapSetup,
15
+ "kanban": runKanbanSetup,
16
+ "agent-workflow": runAgentWorkflowSetup,
17
+ };
18
+ //# sourceMappingURL=setup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAoE;IAC9F,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,aAAa,EAAE,kBAAkB;IACjC,iBAAiB,EAAE,sBAAsB;IACzC,iBAAiB,EAAE,sBAAsB;IACzC,QAAQ,EAAE,cAAc;IACxB,gBAAgB,EAAE,qBAAqB;CACxC,CAAC"}
@@ -0,0 +1,65 @@
1
+ /** Versioned, bounded probes; arbitrary commands and caller workspaces are never accepted. */
2
+ export declare const PRESET_SCENARIOS: readonly ["create-task", "claim-start", "close-without-evidence", "close-with-evidence"];
3
+ /** Identifies a built-in agent workflow, rather than executable user input. */
4
+ export type PresetScenarioId = typeof PRESET_SCENARIOS[number];
5
+ /** Failure categories agents can branch on before retrying. */
6
+ export type SimulationRefusalCode = "unknown_preset" | "unknown_scenario" | "duplicate_scenario" | "sdk_unavailable" | "simulation_failed";
7
+ /** Actionable refusal; internal paths and raw child diagnostics never escape. */
8
+ export declare class SimulationRefusal extends Error {
9
+ /** Stable machine-readable category. */
10
+ readonly code: SimulationRefusalCode;
11
+ /** A concrete next action for the caller. */
12
+ readonly remedy: string;
13
+ /** Usage failures are distinct from execution failures. */
14
+ readonly exitCode: number;
15
+ /** Construct a refusal without exposing the caller's configuration or filesystem. */
16
+ constructor(code: SimulationRefusalCode, remedy: string, exitCode?: number);
17
+ }
18
+ /** Select a subset to inspect; omissions remain visible as coverage gaps. */
19
+ export interface PresetSimulationOptions {
20
+ /** Bundled preset id (same names accepted by presets apply). */
21
+ readonly preset: string;
22
+ /** Defaults to the complete suite. An empty list explicitly measures no scenarios. */
23
+ readonly scenarios?: readonly PresetScenarioId[];
24
+ }
25
+ /** Stable observations, excluding random ids, clock values, warnings and local paths. */
26
+ export interface PresetScenarioResult {
27
+ /** Workflow that was executed. */
28
+ readonly id: PresetScenarioId;
29
+ /** Declared expected end state for this preset's governance. */
30
+ readonly expected: "open" | "in_progress" | "closed" | "refused";
31
+ /** Measured end state; unexpected failures remain visible. */
32
+ readonly actual: "open" | "in_progress" | "closed" | "refused";
33
+ /** Whether the observation matched the declared behavior. */
34
+ readonly passed: boolean;
35
+ /** Stable advice when the workflow was refused. */
36
+ readonly remedy: string;
37
+ }
38
+ /** Compact SDK/TOON/JSON report; partial coverage can never look complete. */
39
+ export interface PresetSimulationReport {
40
+ /** False for a mismatch or omitted workflow. */
41
+ readonly ok: boolean;
42
+ /** Contract version for comparing deterministic reports. */
43
+ readonly suiteVersion: 1;
44
+ /** Canonical preset identifier. */
45
+ readonly preset: string;
46
+ /** Execution boundary, independent of the invoking workspace. */
47
+ readonly isolation: "synthetic-no-extensions";
48
+ /** Number of workflows actually executed. */
49
+ readonly checked: number;
50
+ /** Number matching their declared expectations. */
51
+ readonly passed: number;
52
+ /** Omitted workflows, in canonical suite order. */
53
+ readonly coverageGaps: readonly PresetScenarioId[];
54
+ /** Limits that apply even when every declared scenario passes. */
55
+ readonly limitations: readonly string[];
56
+ /** Results in canonical suite order, independent of selection order. */
57
+ readonly scenarios: readonly PresetScenarioResult[];
58
+ }
59
+ /** Resolve the peer from the package or the CLI host, including standalone extension copies. */
60
+ export declare function resolveSimulationSdk(anchors: readonly string[]): string;
61
+ /** Apply settings and execute real SDK operations; called only inside the isolated process. */
62
+ export declare function executeSyntheticScenarios(root: string, preset: string, scenarios: readonly PresetScenarioId[], sdkPath: string): Promise<PresetSimulationReport>;
63
+ /** Simulate before installing: no caller tracker is read, copied, installed into, or mutated. */
64
+ export declare function simulatePreset(options: PresetSimulationOptions): PresetSimulationReport;
65
+ //# sourceMappingURL=simulation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../src/simulation.ts"],"names":[],"mappings":"AAWA,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,0FAA0G,CAAC;AACxI,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC/D,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAC3I,iFAAiF;AACjF,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,YAAY,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAI,EAMpE;CACF;AACD,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAClD;AACD,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IACjE,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/D,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACrD;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CASvE;AAED,+FAA+F;AAC/F,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,gBAAgB,EAAE,EACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,CAAC,CA6DjC;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6BvF"}
@@ -0,0 +1,134 @@
1
+ /** Reproducible agent lifecycle probes against disposable, integration-free trackers. */
2
+ import { spawnSync } from "node:child_process";
3
+ import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
4
+ import { createRequire } from "node:module";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { pathToFileURL } from "node:url";
8
+ import { findPresetDefinition, requirePresetDefinition } from "./catalog.js";
9
+ import { PRESET_HANDLERS } from "./setup.js";
10
+ /** Versioned, bounded probes; arbitrary commands and caller workspaces are never accepted. */
11
+ export const PRESET_SCENARIOS = Object.freeze(["create-task", "claim-start", "close-without-evidence", "close-with-evidence"]);
12
+ /** Actionable refusal; internal paths and raw child diagnostics never escape. */
13
+ export class SimulationRefusal extends Error {
14
+ /** Stable machine-readable category. */
15
+ code;
16
+ /** A concrete next action for the caller. */
17
+ remedy;
18
+ /** Usage failures are distinct from execution failures. */
19
+ exitCode;
20
+ /** Construct a refusal without exposing the caller's configuration or filesystem. */
21
+ constructor(code, remedy, exitCode = 2) {
22
+ super(`${code}: ${remedy}`);
23
+ this.name = "SimulationRefusal";
24
+ this.code = code;
25
+ this.remedy = remedy;
26
+ this.exitCode = exitCode;
27
+ }
28
+ }
29
+ /** Resolve the peer from the package or the CLI host, including standalone extension copies. */
30
+ export function resolveSimulationSdk(anchors) {
31
+ for (const anchor of anchors) {
32
+ try {
33
+ return createRequire(anchor).resolve("@unbrained/pm-cli/sdk");
34
+ }
35
+ catch {
36
+ // The extension copy may have no node_modules; try the host next.
37
+ }
38
+ }
39
+ throw new SimulationRefusal("sdk_unavailable", "Run with a pm CLI host >=2026.9.30 or install the declared peer dependency.", 1);
40
+ }
41
+ /** Apply settings and execute real SDK operations; called only inside the isolated process. */
42
+ export async function executeSyntheticScenarios(root, preset, scenarios, sdkPath) {
43
+ const sdk = createRequire(import.meta.url)(sdkPath);
44
+ const definition = requirePresetDefinition(preset);
45
+ const pmRoot = join(root, ".agents", "pm");
46
+ mkdirSync(pmRoot, { recursive: true });
47
+ writeFileSync(join(pmRoot, "settings.json"), JSON.stringify(await sdk.readSettings(pmRoot)), { flag: "wx", mode: 0o600 });
48
+ const client = new sdk.PmClient({ pmRoot, cwd: root, author: "preset-simulation", noExtensions: true });
49
+ const commandSdk = sdk.createExtensionCommandSdk(pmRoot, client, "preset-simulation", "presets simulate");
50
+ // Audited SDK initialization avoids the host init command's optional Git discovery.
51
+ await commandSdk.mutateWorkspaceSettings({
52
+ operationId: "simulation-init", mutate: (current) => ({ ...current, id_prefix: "sim-" }),
53
+ });
54
+ await PRESET_HANDLERS[definition.id]({
55
+ command: "presets simulate", args: [], options: {}, global: { quiet: true }, pm_root: pmRoot,
56
+ sdk: commandSdk,
57
+ });
58
+ const results = [];
59
+ for (const id of scenarios) {
60
+ const expected = id === "create-task" ? "open" : id === "claim-start" ? "in_progress"
61
+ : id === "close-without-evidence" && definition.id === "bug-triage" ? "refused" : "closed";
62
+ const created = await client.create({
63
+ type: "Task", title: `Synthetic ${id}`, createMode: "progressive", allowDuplicate: true,
64
+ acceptanceCriteria: "The synthetic task has the declared final state.",
65
+ });
66
+ const itemId = created.item.id;
67
+ if (id === "claim-start") {
68
+ await client.claim(itemId);
69
+ await client.update(itemId, { status: "in_progress" });
70
+ }
71
+ let refused = false;
72
+ try {
73
+ if (id === "close-without-evidence") {
74
+ await client.close(itemId, "Synthetic completion");
75
+ }
76
+ if (id === "close-with-evidence") {
77
+ await client.close(itemId, "Synthetic completion", {
78
+ resolution: "Synthetic work completed.", expectedResult: "Declared final state reached.",
79
+ actualResult: "Declared final state reached.",
80
+ });
81
+ }
82
+ }
83
+ catch (error) {
84
+ if (error.code !== "close_validation_missing_fields")
85
+ throw error;
86
+ refused = true;
87
+ }
88
+ const observed = await client.get(itemId, { full: true });
89
+ const actual = refused && observed.item.status === "open" ? "refused" : observed.item.status;
90
+ results.push({ id, expected, actual, passed: expected === actual,
91
+ remedy: actual === "refused" ? "Supply acceptance criteria and resolution/expected/actual evidence; rerun the complete suite." : "" });
92
+ }
93
+ const coverageGaps = PRESET_SCENARIOS.filter((id) => !scenarios.includes(id));
94
+ const passed = results.filter((result) => result.passed).length;
95
+ return {
96
+ ok: passed === results.length && coverageGaps.length === 0,
97
+ suiteVersion: 1, preset: definition.id, isolation: "synthetic-no-extensions", checked: results.length, passed,
98
+ coverageGaps, limitations: ["Built-in Task lifecycle only; templates and custom item types are not exercised.", "External integrations, user configuration and real agent inference are not exercised."],
99
+ scenarios: results,
100
+ };
101
+ }
102
+ /** Simulate before installing: no caller tracker is read, copied, installed into, or mutated. */
103
+ export function simulatePreset(options) {
104
+ const definition = findPresetDefinition(options.preset);
105
+ if (!definition) {
106
+ throw new SimulationRefusal("unknown_preset", "Choose a bundled id from pm presets list.");
107
+ }
108
+ const selected = options.scenarios ?? PRESET_SCENARIOS;
109
+ if (selected.some((id) => !PRESET_SCENARIOS.includes(id))) {
110
+ throw new SimulationRefusal("unknown_scenario", `Choose scenario ids from: ${PRESET_SCENARIOS.join(", ")}.`);
111
+ }
112
+ if (new Set(selected).size !== selected.length) {
113
+ throw new SimulationRefusal("duplicate_scenario", "Select each scenario at most once.");
114
+ }
115
+ const sdkPath = resolveSimulationSdk([import.meta.url, pathToFileURL(process.argv[1] ?? process.execPath).href]);
116
+ const root = mkdtempSync(join(tmpdir(), "pm-presets-simulation-"));
117
+ try {
118
+ const output = join(root, "report.json");
119
+ const script = `import {executeSyntheticScenarios} from ${JSON.stringify(import.meta.url)};\nimport {writeFileSync} from 'node:fs';\nconst report = await executeSyntheticScenarios(${JSON.stringify(root)}, ${JSON.stringify(definition.id)}, ${JSON.stringify(PRESET_SCENARIOS.filter((id) => selected.includes(id)))}, ${JSON.stringify(sdkPath)});\nwriteFileSync(${JSON.stringify(output)}, JSON.stringify(report));`;
120
+ const child = spawnSync(process.execPath, ["--input-type=module", "--eval", script], {
121
+ cwd: root, encoding: "utf8", timeout: 60_000, maxBuffer: 1024 * 1024,
122
+ env: { HOME: root, USERPROFILE: root, XDG_CONFIG_HOME: root, XDG_CACHE_HOME: root, TMPDIR: root, TMP: root, TEMP: root,
123
+ PATH: "", GIT_CEILING_DIRECTORIES: root, PM_TELEMETRY_DISABLED: "1", DO_NOT_TRACK: "1", CI: "true", TZ: "UTC" },
124
+ });
125
+ if (child.status !== 0) {
126
+ throw new SimulationRefusal("simulation_failed", "Check the supported pm host and rerun; no caller workspace was changed.", 1);
127
+ }
128
+ return JSON.parse(readFileSync(output, "utf8"));
129
+ }
130
+ finally {
131
+ rmSync(root, { recursive: true, force: true });
132
+ }
133
+ }
134
+ //# sourceMappingURL=simulation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulation.js","sourceRoot":"","sources":["../src/simulation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ExtensionApi } from "@unbrained/pm-cli/sdk/authoring";
2
+ /** Register settings-only migration commands; no workspace discovery or Git subprocess is needed. */
3
+ export declare function registerUpgradeCommands(api: ExtensionApi): void;
4
+ //# sourceMappingURL=upgrade-command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-command.d.ts","sourceRoot":"","sources":["../src/upgrade-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA6B3F,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAqC/D"}
@@ -0,0 +1,76 @@
1
+ /** CLI boundary for private migration artifacts and compact agent-facing results. */
2
+ import { closeSync, constants, fstatSync, openSync, readSync, writeFileSync } from "node:fs";
3
+ import { readStringOption } from "./presets/shared.js";
4
+ import { executePresetUpgrade, parseUpgradeReceipt, planPresetUpgrade, summarizePresetUpgrade, UpgradeRefusal } from "./upgrade.js";
5
+ /** Read one bounded JSON artifact, suppressing filesystem paths and private parser diagnostics. */
6
+ function artifact(file) {
7
+ if (!file)
8
+ throw new UpgradeRefusal("invalid_input", "Provide the required JSON artifact flags; see pm presets upgrade plan --help.");
9
+ try {
10
+ const fd = openSync(file, constants.O_RDONLY | constants.O_NONBLOCK);
11
+ try {
12
+ const stat = fstatSync(fd);
13
+ if (!stat.isFile())
14
+ throw new Error("artifact size or type");
15
+ const buffer = Buffer.alloc(1024 * 1024 + 1);
16
+ let size = 0;
17
+ while (size < buffer.length) {
18
+ const count = readSync(fd, buffer, size, buffer.length - size, null);
19
+ if (count === 0)
20
+ break;
21
+ size += count;
22
+ }
23
+ if (size > 1024 * 1024)
24
+ throw new Error("artifact grew beyond limit");
25
+ return JSON.parse(buffer.subarray(0, size).toString("utf8"));
26
+ }
27
+ finally {
28
+ closeSync(fd);
29
+ }
30
+ }
31
+ catch {
32
+ throw new UpgradeRefusal("invalid_input", "Use a readable regular JSON file no larger than 1 MiB.");
33
+ }
34
+ }
35
+ /** Register settings-only migration commands; no workspace discovery or Git subprocess is needed. */
36
+ export function registerUpgradeCommands(api) {
37
+ api.registerCommand({
38
+ name: "presets upgrade plan", action: "presets-upgrade-plan",
39
+ description: "Plan versioned vendor settings evolution and save a private recovery receipt without mutating the tracker.",
40
+ examples: ["pm presets upgrade plan --from vendor-v1.json --to vendor-v2.json --receipt upgrade.private.json", "pm presets upgrade plan --from vendor-v1.json --to vendor-v2.json --decisions decisions.json --receipt resolved.private.json --json"],
41
+ flags: [
42
+ { long: "--from", value_type: "string", value_name: "<file>", description: "Original versioned vendor settings JSON." },
43
+ { long: "--to", value_type: "string", value_name: "<file>", description: "Target versioned vendor settings JSON." },
44
+ { long: "--decisions", value_type: "string", value_name: "<file>", description: "JSON pointer to local/vendor conflict decisions." },
45
+ { long: "--generation", value_type: "string", value_name: "<id>", description: "Explicit new migration generation after rollback; defaults to 1 for stable retries." },
46
+ { long: "--receipt", value_type: "string", value_name: "<file>", description: "New private receipt file; existing files are never overwritten." },
47
+ ],
48
+ run: async (ctx) => {
49
+ const output = readStringOption(ctx.options, "receipt");
50
+ if (!output)
51
+ throw new UpgradeRefusal("invalid_input", "Provide --receipt with a new private file to retain recovery settings before applying.");
52
+ const decisionFile = readStringOption(ctx.options, "decisions");
53
+ const receipt = await planPresetUpgrade(ctx.sdk, artifact(readStringOption(ctx.options, "from")), artifact(readStringOption(ctx.options, "to")), decisionFile ? artifact(decisionFile) : {}, readStringOption(ctx.options, "generation"));
54
+ try {
55
+ const serialized = JSON.stringify(receipt) + "\n";
56
+ if (Buffer.byteLength(serialized) > 1024 * 1024)
57
+ throw new Error("receipt too large");
58
+ writeFileSync(output, serialized, { flag: "wx", mode: 0o600 });
59
+ }
60
+ catch {
61
+ throw new UpgradeRefusal("invalid_input", "Choose a new writable receipt file; keep the complete receipt below 1 MiB. Existing artifacts are never overwritten.");
62
+ }
63
+ return summarizePresetUpgrade(receipt);
64
+ },
65
+ });
66
+ for (const direction of ["apply", "rollback"]) {
67
+ api.registerCommand({
68
+ name: `presets upgrade ${direction}`, action: `presets-upgrade-${direction}`,
69
+ description: `${direction === "apply" ? "Apply" : "Roll back"} a resolved preset migration through audited SDK settings mutations.`,
70
+ arguments: [{ name: "receipt", required: true, description: "Private JSON receipt saved by presets upgrade plan." }],
71
+ examples: [`pm presets upgrade ${direction} upgrade.private.json --json`],
72
+ run: async (ctx) => executePresetUpgrade(ctx.sdk, parseUpgradeReceipt(artifact(ctx.args?.[0])), direction),
73
+ });
74
+ }
75
+ }
76
+ //# sourceMappingURL=upgrade-command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-command.js","sourceRoot":"","sources":["../src/upgrade-command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,105 @@
1
+ import type { ExtensionCommandSdk } from "@unbrained/pm-cli/sdk/authoring";
2
+ /** JSON settings patches accept nested objects and treat arrays as indivisible values. */
3
+ export type UpgradeSettings = {
4
+ readonly [key: string]: UpgradeValue;
5
+ };
6
+ /** JSON-only values exclude executable inputs and ambiguous undefined properties. */
7
+ export type UpgradeValue = null | boolean | number | string | readonly UpgradeValue[] | UpgradeSettings;
8
+ /** A caller supplies the original vendor patch, not an export of locally customized settings. */
9
+ export interface VersionedPreset {
10
+ /** Stable vendor identity, identical across the two versions. */
11
+ readonly id: string;
12
+ /** Explicit immutable vendor revision or release label. */
13
+ readonly version: string;
14
+ /** Only vendor-owned settings, without templates or tracker items. */
15
+ readonly settings: UpgradeSettings;
16
+ }
17
+ /** Explicit choices use RFC 6901 JSON pointers; missing decisions never default to vendor. */
18
+ export type UpgradeDecisions = Readonly<Record<string, "local" | "vendor">>;
19
+ /** A compact observation reveals paths and choices, never previous setting values. */
20
+ export interface UpgradeChange {
21
+ /** Unambiguous JSON pointer, with escaped slashes and tildes. */
22
+ readonly path: string;
23
+ /** Unchanged vendor settings preserve local customizations automatically. */
24
+ readonly kind: "vendor" | "local" | "already" | "conflict";
25
+ /** Empty for automatic choices or an unresolved conflict. */
26
+ readonly decision: "local" | "vendor" | "";
27
+ }
28
+ /** Private recovery artifact; persist before applying and keep outside version control. */
29
+ export interface PresetUpgradeReceipt {
30
+ /** Version of the receipt contract, independent of vendor versions. */
31
+ readonly schema: 1;
32
+ /** Content digest binding the plan, choices and normalized snapshots. */
33
+ readonly id: string;
34
+ /** Explicit retry generation; increment only to start a new migration after rollback. */
35
+ readonly generation: string;
36
+ /** Original vendor patch and revision. */
37
+ readonly from: VersionedPreset;
38
+ /** Target vendor patch and revision. */
39
+ readonly to: VersionedPreset;
40
+ /** Explicit decisions, including decisions to preserve conflicting local edits. */
41
+ readonly decisions: UpgradeDecisions;
42
+ /** Normalized inline settings observed under the host settings lock. */
43
+ readonly before: UpgradeSettings;
44
+ /** Canonical settings preview returned by the host serializer. */
45
+ readonly after: UpgradeSettings;
46
+ /** Paths requiring attention or recording preserved local intent. */
47
+ readonly changes: readonly UpgradeChange[];
48
+ }
49
+ /** Agents can branch on these categories without parsing raw SDK diagnostics. */
50
+ export type UpgradeRefusalCode = "invalid_input" | "invalid_receipt" | "sdk_required" | "conflicts" | "stale_settings" | "normalization_changed" | "mutation_refused";
51
+ /** Typed failure with a stable remedy; user settings and raw SDK messages stay private. */
52
+ export declare class UpgradeRefusal extends Error {
53
+ /** Stable category suitable for programmatic handling. */
54
+ readonly code: UpgradeRefusalCode;
55
+ /** Concrete corrective action, excluding private diagnostics. */
56
+ readonly remedy: string;
57
+ /** Expected usage/conflict failure, recognized by the pm extension host. */
58
+ readonly exitCode = 2;
59
+ /** Construct a safe, machine-readable refusal. */
60
+ constructor(code: UpgradeRefusalCode, remedy: string);
61
+ }
62
+ /** Compare JSON settings without a host; arrays and structural type changes require atomic choices. */
63
+ export declare function comparePresetUpgrade(from: UpgradeSettings, to: UpgradeSettings, local: UpgradeSettings, decisions?: UpgradeDecisions): {
64
+ after: UpgradeSettings;
65
+ changes: readonly UpgradeChange[];
66
+ };
67
+ /** Plan against the locked inline snapshot; dry-run never changes settings or history. */
68
+ export declare function planPresetUpgrade(sdk: ExtensionCommandSdk, from: VersionedPreset, to: VersionedPreset, decisions?: UpgradeDecisions, generation?: string): Promise<PresetUpgradeReceipt>;
69
+ /** Validate private artifacts received from JSON before any host mutation. Digests detect edits, not authorship. */
70
+ export declare function parseUpgradeReceipt(value: unknown): PresetUpgradeReceipt;
71
+ /** Compact plan report; retrieve all paths from the private receipt when conflicts are truncated. */
72
+ export interface PresetUpgradeSummary {
73
+ /** Full digest to identify the saved artifact. */
74
+ readonly id: string;
75
+ /** Vendor identity retained across versions. */
76
+ readonly preset: string;
77
+ /** Original vendor revision. */
78
+ readonly from: string;
79
+ /** Target vendor revision. */
80
+ readonly to: string;
81
+ /** True only when every conflict has an explicit decision. */
82
+ readonly ready: boolean;
83
+ /** Whether normalized settings differ. */
84
+ readonly changed: boolean;
85
+ /** Total path observations in the private receipt. */
86
+ readonly paths: number;
87
+ /** At most twenty conflicts in canonical path order, within a 4 KiB detail budget. */
88
+ readonly conflicts: readonly UpgradeChange[];
89
+ /** Number of conflicts omitted from this compact view. */
90
+ readonly omittedConflicts: number;
91
+ /** Total observations by classification, including omitted conflicts. */
92
+ readonly counts: Readonly<Record<UpgradeChange["kind"], number>>;
93
+ }
94
+ /** Successful execution acknowledgement; the host history is the durable commit receipt. */
95
+ export interface PresetUpgradeResult extends PresetUpgradeSummary {
96
+ /** Forward migration or restoration of the recorded settings. */
97
+ readonly direction: "apply" | "rollback";
98
+ /** Whether the SDK recognized an already committed operation identity. */
99
+ readonly replayed: boolean;
100
+ }
101
+ /** Bounded result emitted by CLI renderers; full settings stay in the private receipt file. */
102
+ export declare function summarizePresetUpgrade(receipt: PresetUpgradeReceipt): PresetUpgradeSummary;
103
+ /** Apply or roll back exactly once through the host audit lock, refusing stale state and unresolved choices. */
104
+ export declare function executePresetUpgrade(sdk: ExtensionCommandSdk, input: PresetUpgradeReceipt, direction: "apply" | "rollback"): Promise<PresetUpgradeResult>;
105
+ //# sourceMappingURL=upgrade.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,235 @@
1
+ /** Three-way vendor settings evolution, with portable receipts and host-owned auditing. */
2
+ import { createHash } from "node:crypto";
3
+ /** Typed failure with a stable remedy; user settings and raw SDK messages stay private. */
4
+ export class UpgradeRefusal extends Error {
5
+ /** Stable category suitable for programmatic handling. */
6
+ code;
7
+ /** Concrete corrective action, excluding private diagnostics. */
8
+ remedy;
9
+ /** Expected usage/conflict failure, recognized by the pm extension host. */
10
+ exitCode = 2;
11
+ /** Construct a safe, machine-readable refusal. */
12
+ constructor(code, remedy) {
13
+ super(`${code}: ${remedy}`);
14
+ this.name = "UpgradeRefusal";
15
+ this.code = code;
16
+ this.remedy = remedy;
17
+ }
18
+ }
19
+ /** Identify plain data objects, excluding arrays and class instances. */
20
+ function object(value) {
21
+ return value !== null && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype;
22
+ }
23
+ /** Validate bounded JSON and reject prototype keys even in arrays or unused patch branches. */
24
+ function json(value, depth = 0) {
25
+ if (depth > 32)
26
+ throw new UpgradeRefusal("invalid_input", "Limit settings nesting to 32 levels.");
27
+ if (value === null || typeof value === "string" || typeof value === "boolean" || (typeof value === "number" && Number.isFinite(value)))
28
+ return;
29
+ if (Array.isArray(value)) {
30
+ for (const child of value)
31
+ json(child, depth + 1);
32
+ return;
33
+ }
34
+ if (!object(value))
35
+ throw new UpgradeRefusal("invalid_input", "Supply JSON objects, arrays and finite scalar values only.");
36
+ for (const [key, child] of Object.entries(value)) {
37
+ if (["__proto__", "constructor", "prototype"].includes(key))
38
+ throw new UpgradeRefusal("invalid_input", "Remove prototype-related settings keys.");
39
+ json(child, depth + 1);
40
+ }
41
+ }
42
+ /** Sort object keys so formatting and insertion order cannot change a receipt identity. */
43
+ function canonical(value) {
44
+ if (Array.isArray(value))
45
+ return `[${value.map(canonical).join(",")}]`;
46
+ if (object(value))
47
+ return `{${Object.keys(value).filter((key) => value[key] !== undefined).sort().map((key) => `${JSON.stringify(key)}:${canonical(value[key])}`).join(",")}}`;
48
+ return String(JSON.stringify(value));
49
+ }
50
+ /** Compare missing values distinctly from null, empty objects and empty arrays. */
51
+ function equal(left, right) {
52
+ return canonical(left) === canonical(right);
53
+ }
54
+ /** Validate a vendor patch before reading any workspace state. */
55
+ function vendor(value) {
56
+ if (!object(value) || typeof value.id !== "string" || !/^[a-zA-Z0-9._-]{1,100}$/.test(value.id)
57
+ || typeof value.version !== "string" || !/^[a-zA-Z0-9._+-]{1,100}$/.test(value.version) || !object(value.settings)
58
+ || Object.keys(value).some((key) => !["id", "version", "settings"].includes(key))) {
59
+ throw new UpgradeRefusal("invalid_input", "Supply {id, version, settings} with nonempty stable labels and an object patch.");
60
+ }
61
+ json(value);
62
+ }
63
+ /** Validate choices before using them as paths or decisions. */
64
+ function choices(value) {
65
+ if (!object(value) || Object.entries(value).some(([key, choice]) => !key.startsWith("/") || !["local", "vendor"].includes(String(choice)))) {
66
+ throw new UpgradeRefusal("invalid_input", "Supply an object mapping conflict JSON pointers to local or vendor.");
67
+ }
68
+ json(value);
69
+ }
70
+ /** Merge only vendor-owned paths; structural changes and arrays are atomic conflicts. */
71
+ function migrate(from, to, before, decisions) {
72
+ const changes = [];
73
+ const used = new Set();
74
+ /** Resolve one subtree without traversing local-only fields. */
75
+ function visit(base, next, local, path) {
76
+ if ((object(base) || base === undefined) && (object(next) || next === undefined) && object(local) && next !== undefined) {
77
+ const result = structuredClone(local);
78
+ const keys = new Set([...Object.keys(base ?? {}), ...Object.keys(next)]);
79
+ for (const key of [...keys].sort()) {
80
+ const child = visit(base?.[key], next[key], local[key], `${path}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`);
81
+ if (child === undefined)
82
+ delete result[key];
83
+ else
84
+ result[key] = child;
85
+ }
86
+ return result;
87
+ }
88
+ if (equal(base, next)) {
89
+ if (!equal(base, local))
90
+ changes.push({ path, kind: "local", decision: "" });
91
+ return local;
92
+ }
93
+ if (equal(local, base)) {
94
+ changes.push({ path, kind: "vendor", decision: "" });
95
+ return next;
96
+ }
97
+ if (equal(local, next)) {
98
+ changes.push({ path, kind: "already", decision: "" });
99
+ return local;
100
+ }
101
+ const decision = decisions[path] ?? "";
102
+ used.add(path);
103
+ changes.push({ path, kind: "conflict", decision });
104
+ return decision === "vendor" ? next : local;
105
+ }
106
+ const after = visit(from, to, before, "");
107
+ if (Object.keys(decisions).some((key) => !used.has(key)))
108
+ throw new UpgradeRefusal("invalid_input", "Remove decisions for paths that are not conflicts in this plan.");
109
+ return { after, changes };
110
+ }
111
+ /** Compare JSON settings without a host; arrays and structural type changes require atomic choices. */
112
+ export function comparePresetUpgrade(from, to, local, decisions = {}) {
113
+ for (const value of [from, to, local]) {
114
+ if (!object(value))
115
+ throw new UpgradeRefusal("invalid_input", "Supply object settings snapshots for all three comparison inputs.");
116
+ json(value);
117
+ }
118
+ choices(decisions);
119
+ return migrate(from, to, local, decisions);
120
+ }
121
+ /** Bind the complete artifact rather than relying on the caller's filename or operation id. */
122
+ function identity(receipt) {
123
+ return createHash("sha256").update(canonical(receipt)).digest("hex");
124
+ }
125
+ /** Enforce the host capability and translate execution failures without exposing configuration. */
126
+ async function mutation(sdk, options) {
127
+ if (typeof sdk?.mutateWorkspaceSettings !== "function")
128
+ throw new UpgradeRefusal("sdk_required", "Use a pm host with audited settings mutation and canonical includePreview support (2026.10.17+).");
129
+ try {
130
+ return await sdk.mutateWorkspaceSettings(options);
131
+ }
132
+ catch (error) {
133
+ if (error instanceof UpgradeRefusal)
134
+ throw error;
135
+ throw new UpgradeRefusal("mutation_refused", "Check pm health and the settings schema, then retry with the same receipt; retain the artifact for recovery.");
136
+ }
137
+ }
138
+ /** Replace only the smallest object containing removed leaves; other raw source fields remain host-owned. */
139
+ function removedSubtrees(before, after, prefix = "") {
140
+ if (prefix && Object.keys(before).some((key) => !(key in after)))
141
+ return [prefix];
142
+ return Object.keys(before).flatMap((key) => object(before[key]) && object(after[key])
143
+ ? removedSubtrees(before[key], after[key], prefix ? `${prefix}.${key}` : key) : []);
144
+ }
145
+ /** Plan against the locked inline snapshot; dry-run never changes settings or history. */
146
+ export async function planPresetUpgrade(sdk, from, to, decisions = {}, generation = "1") {
147
+ if (!/^[a-zA-Z0-9._-]{1,64}$/.test(generation))
148
+ throw new UpgradeRefusal("invalid_input", "Use a nonempty migration generation of at most 64 letters, digits, dots, underscores or hyphens.");
149
+ vendor(from);
150
+ vendor(to);
151
+ choices(decisions);
152
+ if (from.id !== to.id || from.version === to.version)
153
+ throw new UpgradeRefusal("invalid_input", "Use the same vendor id with two different immutable version labels.");
154
+ let before = {};
155
+ let proposed = {};
156
+ let changes = [];
157
+ const replacements = [];
158
+ const preview = await mutation(sdk, {
159
+ operationId: "preset-upgrade-preview", dryRun: true, includePreview: true,
160
+ replaceSubtrees: replacements,
161
+ mutate: (current) => {
162
+ before = JSON.parse(JSON.stringify(current));
163
+ const result = migrate(from.settings, to.settings, before, decisions);
164
+ proposed = result.after;
165
+ replacements.push(...removedSubtrees(before, proposed));
166
+ changes = result.changes;
167
+ return proposed;
168
+ },
169
+ });
170
+ if (!preview.preview)
171
+ throw new UpgradeRefusal("sdk_required", "Upgrade the pm host to support canonical includePreview settings results (2026.10.17+).");
172
+ if (!equal(preview.preview, proposed))
173
+ throw new UpgradeRefusal("normalization_changed", "Adjust the vendor patch to the host's canonical settings schema and explicit governance policy, then replan.");
174
+ const receipt = { schema: 1, generation, from, to, decisions, before, after: JSON.parse(JSON.stringify(preview.preview)), changes };
175
+ return structuredClone({ ...receipt, id: identity(receipt) });
176
+ }
177
+ /** Validate private artifacts received from JSON before any host mutation. Digests detect edits, not authorship. */
178
+ export function parseUpgradeReceipt(value) {
179
+ json(value);
180
+ if (!object(value) || value.schema !== 1 || typeof value.generation !== "string" || !/^[a-zA-Z0-9._-]{1,64}$/.test(value.generation) || typeof value.id !== "string" || !object(value.before) || !object(value.after) || !Array.isArray(value.changes)) {
181
+ throw new UpgradeRefusal("invalid_receipt", "Use the complete unchanged receipt written by presets upgrade plan.");
182
+ }
183
+ const { id, ...body } = value;
184
+ if (identity(body) !== id)
185
+ throw new UpgradeRefusal("invalid_receipt", "Restore the unchanged receipt; regenerate a plan to change decisions.");
186
+ const receipt = value;
187
+ vendor(receipt.from);
188
+ vendor(receipt.to);
189
+ choices(receipt.decisions);
190
+ const expected = migrate(receipt.from.settings, receipt.to.settings, receipt.before, receipt.decisions);
191
+ if (receipt.from.id !== receipt.to.id || receipt.from.version === receipt.to.version || !equal(expected.after, receipt.after) || !equal(expected.changes, receipt.changes)) {
192
+ throw new UpgradeRefusal("invalid_receipt", "Regenerate the receipt from the original vendor versions and explicit decisions.");
193
+ }
194
+ return receipt;
195
+ }
196
+ /** Bounded result emitted by CLI renderers; full settings stay in the private receipt file. */
197
+ export function summarizePresetUpgrade(receipt) {
198
+ const conflicts = receipt.changes.filter((change) => change.kind === "conflict");
199
+ let bytes = 0;
200
+ const visible = conflicts.slice(0, 20).filter((change) => {
201
+ bytes += Buffer.byteLength(JSON.stringify(change));
202
+ return bytes <= 4096;
203
+ });
204
+ return { id: receipt.id, preset: receipt.from.id, from: receipt.from.version, to: receipt.to.version,
205
+ ready: !receipt.changes.some((change) => change.kind === "conflict" && change.decision === ""),
206
+ changed: !equal(receipt.before, receipt.after), paths: receipt.changes.length,
207
+ conflicts: visible, omittedConflicts: conflicts.length - visible.length,
208
+ counts: { vendor: receipt.changes.filter((change) => change.kind === "vendor").length, local: receipt.changes.filter((change) => change.kind === "local").length, already: receipt.changes.filter((change) => change.kind === "already").length, conflict: conflicts.length } };
209
+ }
210
+ /** Apply or roll back exactly once through the host audit lock, refusing stale state and unresolved choices. */
211
+ export async function executePresetUpgrade(sdk, input, direction) {
212
+ const receipt = parseUpgradeReceipt(input);
213
+ if (direction !== "apply" && direction !== "rollback")
214
+ throw new UpgradeRefusal("invalid_input", "Choose apply or rollback.");
215
+ if (!summarizePresetUpgrade(receipt).ready)
216
+ throw new UpgradeRefusal("conflicts", "Supply local or vendor for every conflict in a decisions file and generate a new receipt.");
217
+ const [before, after] = direction === "apply" ? [receipt.before, receipt.after] : [receipt.after, receipt.before];
218
+ const result = await mutation(sdk, {
219
+ operationId: `preset-${direction}-${receipt.id}`, replaceSubtrees: removedSubtrees(before, after),
220
+ mutate: (current) => {
221
+ if (!equal(current, before) && !equal(current, after))
222
+ throw new UpgradeRefusal("stale_settings", "Settings changed since this receipt; replan against current settings before applying or rolling back.");
223
+ return structuredClone(after);
224
+ },
225
+ });
226
+ // Replay skips the callback. Check the live snapshot before reporting success,
227
+ // including retries after a rollback or a concurrent later settings mutation.
228
+ await mutation(sdk, { operationId: "preset-upgrade-verify", dryRun: true, mutate: (current) => {
229
+ if (!equal(current, after))
230
+ throw new UpgradeRefusal("stale_settings", "The operation was replayed or settings changed after it; inspect history and replan with a new explicit generation for further migration.");
231
+ return current;
232
+ } });
233
+ return { ...summarizePresetUpgrade(receipt), direction, changed: result.changed, replayed: result.replayed };
234
+ }
235
+ //# sourceMappingURL=upgrade.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ # Inspect preset behavior before applying
2
+
3
+ ```typescript
4
+ import { simulatePreset, SimulationRefusal } from "pm-presets";
5
+
6
+ try {
7
+ const report = simulatePreset({ preset: "bug-triage" });
8
+ console.log(report.ok, report.checked, report.passed); // true, 4, 4
9
+ const close = report.scenarios.find(row => row.id === "close-without-evidence");
10
+ console.log(close?.expected, close?.actual); // refused, refused
11
+
12
+ const partial = simulatePreset({ preset: "indie-dev", scenarios: ["create-task"] });
13
+ console.log(partial.ok); // false: three workflows remain unmeasured
14
+ console.log(partial.coverageGaps);
15
+ } catch (error) {
16
+ if (!(error instanceof SimulationRefusal)) throw error;
17
+ console.error(error.code, error.remedy, error.exitCode);
18
+ }
19
+ ```
20
+
21
+ The SDK call is synchronous and bounded by a 60 second worker deadline. It
22
+ creates, claims, updates and closes synthetic Tasks using a local pm SDK with
23
+ extensions disabled. The constructor accepts no tracker/client/command override.
24
+ Missing selections are explicit even for `scenarios: []`. Unknown runtime IDs and
25
+ duplicate selections are refused before a worker starts.
26
+
27
+ ```sh
28
+ pm presets simulate bug-triage --json
29
+ # ok:true, checked:4, passed:4; close-without-evidence is an expected refusal
30
+
31
+ pm presets simulate indie-dev --scenarios create-task --json
32
+ # exit 4; coverageGaps: claim-start, close-without-evidence, close-with-evidence
33
+ ```
34
+
35
+ The JSON and default TOON reports contain the same fields. On partial coverage,
36
+ the error path prints a single compact JSON report before the host's error text.
37
+ Read `limitations` even for a complete passing suite: templates and custom types
38
+ are installed as part of setup but their creation workflows are not evaluated.
39
+ The suite never connects to external trackers or runs agent inference.
@@ -0,0 +1,95 @@
1
+ # Upgrade vendor settings without losing local intent
2
+
3
+ Keep the original vendor patch, its immutable version label, and the next vendor
4
+ patch. A workspace export contains local customizations and is not a substitute
5
+ for the original patch. For example, `vendor-v1.json`:
6
+
7
+ ```json
8
+ {"id":"team-policy","version":"1.0.0","settings":{"id_prefix":"team-","output":{"default_format":"toon"}}}
9
+ ```
10
+
11
+ And `vendor-v2.json`:
12
+
13
+ ```json
14
+ {"id":"team-policy","version":"2.0.0","settings":{"id_prefix":"team2-","output":{"default_format":"json"}}}
15
+ ```
16
+
17
+ If the workspace prefix is `local-`, the prefix is a conflict while the unchanged
18
+ local output format can adopt the vendor change automatically:
19
+
20
+ ```sh
21
+ pm presets upgrade plan --from vendor-v1.json --to vendor-v2.json --receipt upgrade.private.json
22
+ ```
23
+
24
+ The compact TOON report contains a receipt digest, `ready: false`, counts, and
25
+ `/id_prefix` as an unresolved conflict. `--json` selects the same data as JSON.
26
+ Planning writes only a new private receipt file, never tracker settings/history.
27
+ It refuses to overwrite an existing artifact. The receipt contains complete
28
+ inline settings for recovery, is created with mode 0600, and must remain outside
29
+ version control. Protect backups of this artifact as you protect settings.
30
+
31
+ Save an explicit `decisions.json`:
32
+
33
+ ```json
34
+ {"/id_prefix":"local"}
35
+ ```
36
+
37
+ Then generate a resolved receipt and apply it:
38
+
39
+ ```sh
40
+ pm presets upgrade plan --from vendor-v1.json --to vendor-v2.json --decisions decisions.json --receipt resolved.private.json --json
41
+ pm presets upgrade apply resolved.private.json --json
42
+ pm presets upgrade apply resolved.private.json --json
43
+ pm presets upgrade rollback resolved.private.json --json
44
+ pm presets upgrade rollback resolved.private.json --json
45
+ ```
46
+
47
+ The second apply and rollback are retries: they do not add duplicate history
48
+ entries. The host's settings history records the digest in the operation id and
49
+ the invoking author. Retain the receipt before attempting apply so interrupted
50
+ invocations can be retried. Inspect history and replan after a completed rollback;
51
+ an old apply receipt cannot be used to silently reapply a rolled-back operation.
52
+ To deliberately apply again, plan with a new explicit `--generation 2`.
53
+
54
+ Arrays are atomic. Conflicting additions, deletions, and structural type changes
55
+ also require `local` or `vendor`. Choices use JSON pointers, escaping `~` as `~0`
56
+ and `/` as `~1`; unknown/nonconflicting decision paths are refused. Unchanged
57
+ vendor paths and local-only settings retain local intent. Deleting a setting
58
+ that the host requires or normalizes to a default is refused; make the target
59
+ patch explicit using valid host settings. File-backed schema overlays are outside
60
+ the inline settings scope.
61
+
62
+ Both apply and rollback compare the complete normalized inline settings under
63
+ the host audit lock. Later edits, including edits to unrelated settings, refuse
64
+ rollback rather than overwrite them. Resolve those edits with a fresh plan and
65
+ history inspection. Use `--generation 2` (or another new explicit label) when
66
+ planning a deliberate new apply after a rollback; keep the default generation for
67
+ retries of the same operation. Templates, seeds, item types, items, integrations and external
68
+ configuration are not migrated. Receipts are portable trusted input: their digest
69
+ detects accidental edits, not authorship or permission to change a workspace.
70
+ Do not apply a receipt from an untrusted party or another workspace.
71
+
72
+ SDK callers use the host command SDK already provided to extensions:
73
+
74
+ ```ts
75
+ import { planPresetUpgrade, executePresetUpgrade, summarizePresetUpgrade } from "pm-presets";
76
+ import type { VersionedPreset } from "pm-presets";
77
+
78
+ // from and to are trusted VersionedPreset documents; ctx is the host command context.
79
+ const receipt = await planPresetUpgrade(ctx.sdk, from, to, { "/id_prefix": "local" });
80
+ const summary = summarizePresetUpgrade(receipt);
81
+ // Persist the complete receipt privately before calling executePresetUpgrade.
82
+ if (summary.ready) await executePresetUpgrade(ctx.sdk, receipt, "apply");
83
+ ```
84
+
85
+ `comparePresetUpgrade` is the pure JSON comparison API. `parseUpgradeReceipt`
86
+ validates a saved artifact before execution. `UpgradeRefusal` exposes `code`,
87
+ `remedy` and `exitCode`; codes include `invalid_input`, `invalid_receipt`,
88
+ `sdk_required`, `conflicts`, `stale_settings`, `normalization_changed` and
89
+ `mutation_refused`. CLI errors include the stable code and remedy and exit 2.
90
+ The private receipt holds all observations; command reports cap conflict details
91
+ at 20 and 4 KiB of details, and declare `omittedConflicts` alongside complete counts. Input files must
92
+ be regular JSON files of at most 1 MiB. Canonical preview support requires a host
93
+ SDK from 2026.10.17 or newer; earlier hosts receive a remedy without fallback
94
+ filesystem writes. Dry-run planning still requires the host's transient lock
95
+ directory to be writable; settings, items and history are not modified.
package/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pm-presets",
3
- "version": "2026.10.20",
3
+ "version": "2026.10.23",
4
4
  "description": "All 7 official pm-cli workspace presets in one package: bug-triage, indie-dev, open-source, software-sprint, startup-roadmap, kanban, agent-workflow",
5
5
  "author": "@unbraind",
6
6
  "entry": "./dist/index.js",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pm-presets",
3
- "version": "2026.10.20",
3
+ "version": "2026.10.23",
4
4
  "description": "All 7 official pm-cli workspace presets in one package: bug-triage, indie-dev, open-source, software-sprint, startup-roadmap, kanban, agent-workflow",
5
5
  "repository": {
6
6
  "type": "git",
@@ -28,7 +28,9 @@
28
28
  "manifest.json",
29
29
  "README.md",
30
30
  "CHANGELOG.md",
31
- "presets.json"
31
+ "presets.json",
32
+ "docs/simulation-example.md",
33
+ "docs/upgrade-example.md"
32
34
  ],
33
35
  "scripts": {
34
36
  "build": "tsc",
@@ -57,9 +59,9 @@
57
59
  },
58
60
  "devDependencies": {
59
61
  "@types/node": "^26.2.0",
60
- "@unbrained/pm-cli": "2026.10.15",
62
+ "@unbrained/pm-cli": "2026.10.17",
61
63
  "pm-changelog": "2026.10.16",
62
- "pm-ops": "2026.10.16",
64
+ "pm-ops": "2026.10.17",
63
65
  "typescript": "^7.0.2"
64
66
  },
65
67
  "engines": {
@@ -123,10 +125,14 @@
123
125
  },
124
126
  "docs": [
125
127
  "README.md",
126
- "CHANGELOG.md"
128
+ "CHANGELOG.md",
129
+ "docs/simulation-example.md",
130
+ "docs/upgrade-example.md"
127
131
  ],
128
132
  "examples": [
129
- "README.md"
133
+ "README.md",
134
+ "docs/simulation-example.md",
135
+ "docs/upgrade-example.md"
130
136
  ]
131
137
  },
132
138
  "publishConfig": {