@unbrained/pm-cli 2026.7.16 → 2026.7.17

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.7.16"
+    "version": "2026.7.17"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.7.16",
+      "version": "2026.7.17",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2026.7.17 - 2026-07-17
+
+### Added
+
+- SDK-only exemplar: minimal custom PM CLI package proving the universal-tool story end-to-end ([pm-cbwg](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-cbwg.toon))
+- Promote query/read primitives to the public SDK: list, get, search, context, next, aggregate, stats ([pm-rjqr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-rjqr.toon))
+- Promote execution and diagnostics primitives to the public SDK: linked-test running and test-run lifecycle, search eval harness, telemetry stats/export ([pm-oslr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-oslr.toon))
+
+### Fixed
+
+- cli/main.ts commander program is a module-level singleton: dynamically registered extension commands/flags persist across in-process invocations ([pm-qfdd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-qfdd.toon))
+- Windows packed-extension install regression exceeds the generic Vitest timeout ([pm-ph3i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ph3i.toon))
+
+### Other
+
+- Sentry CLI token needs broader scopes for issue analysis ([pm-q4jp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-q4jp.toon))
+
 ## 2026.7.16 - 2026-07-16
 
 ### Other
@@ -241,7 +258,6 @@
 ### Added
 
 - Promote item lifecycle primitives to the public SDK: create, update, close, claim/release, copy, delete, restore, focus ([pm-98cz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-98cz.toon))
-- Promote query/read primitives to the public SDK: list, get, search, context, next, aggregate, stats ([pm-rjqr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-rjqr.toon))
 
 ### Fixed
 
@@ -1698,7 +1714,6 @@
 - Lower Sentry tracesSampleRate from 1.0 to 0.2 for free plan quota ([pm-wvhs](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-wvhs.toon))
 - 2026-05-01 Full PM CLI Audit Implementation ([pm-twpc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/epics/pm-twpc.toon))
 - 2026-05-02 Comprehensive PM CLI Audit ([pm-rrjv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/epics/pm-rrjv.toon))
-- Sentry CLI token needs broader scopes for issue analysis ([pm-q4jp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-q4jp.toon))
 - Dead code: root-level facade re-export shims unused ([pm-nr8k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-nr8k.toon))
 - Decision: 2026-05-02 Comprehensive Audit Results ([pm-mve5](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-mve5.toon))
 - Telemetry: Backfill legacy source_context ([pm-dqer](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-dqer.toon))

package/CONTRIBUTING.md

@@ -104,7 +104,7 @@ The full set of pre-existing violations is grandfathered in
 
 Do not regenerate the whole baseline (`pnpm lint:complexity:baseline`) to silence a
 new violation; that defeats the gate — and the static quality gate enforces a hard
-budget (`MAX_ESLINT_SUPPRESSIONS` in `scripts/release/static-quality-gate.mjs`) on
+budget (`MAX_ESLINT_SUPPRESSIONS` in `scripts/release/static-quality-gate.mts`) on
 the baseline's total size, so growing it fails CI outright. Lower the budget as the
 baseline burns down. Driving the baseline to empty is the path to a CodeFactor
 **A+** (tracked under epic `pm-92if`).
@@ -119,7 +119,7 @@ inline escape hatches that could otherwise silence a gate without touching any
 config file a reviewer would watch: inline `eslint-disable` comments, coverage
 ignore pragmas (`v8 ignore` / `c8 ignore` / `istanbul ignore`), and
 `jscpd:ignore` blocks (budget 0 — never allowed). The ceilings live in
-`scripts/release/static-quality-gate.mjs` (`MAX_INLINE_ESLINT_DISABLES`,
+`scripts/release/static-quality-gate.mts` (`MAX_INLINE_ESLINT_DISABLES`,
 `MAX_COVERAGE_IGNORE_PRAGMAS`, `MAX_JSCPD_IGNORE_PRAGMAS`); adding a new pragma
 anywhere in the scanned surfaces fails CI. Lower the budgets as usage burns
 down — never raise them.

package/dist/cli/bootstrap-args.d.ts

@@ -1,119 +1,6 @@
 /**
  * @module cli/bootstrap-args
  *
- * Provides CLI runtime support for Bootstrap Args.
+ * Preserves the CLI compatibility path for SDK-owned bootstrap primitives.
  */
-import { EXECUTABLE_COMMAND_ALIASES, type CliFlagContract } from "../sdk/cli-contracts.js";
-export { EXECUTABLE_COMMAND_ALIASES };
-/** Documents the bootstrap global options payload exchanged by command, SDK, and package integrations. */
-export interface BootstrapGlobalOptions {
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions: boolean;
-    /** Value that configures or reports no pager for this contract. */
-    noPager: boolean;
-    /** Value that configures or reports json for this contract. */
-    json: boolean;
-    /** Value that configures or reports quiet for this contract. */
-    quiet: boolean;
-    /** Invocation-wide mutation author override. */
-    author?: string;
-    /** Whether `--author` was present without its required value. */
-    authorMissingValue?: true;
-}
-/** Implements parse bootstrap global options for the public runtime surface of this module. */
-export declare function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions;
-/** Implements strip global bootstrap tokens for the public runtime surface of this module. */
-export declare function stripGlobalBootstrapTokens(argv: string[]): string[];
-/** Documents the bootstrap help request payload exchanged by command, SDK, and package integrations. */
-export interface BootstrapHelpRequest {
-    /** Value that configures or reports requested for this contract. */
-    requested: boolean;
-    /** Value that configures or reports command path tokens for this contract. */
-    commandPathTokens: string[];
-}
-/** Implements parse bootstrap help request for the public runtime surface of this module. */
-export declare function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest;
-/** Implements parse bootstrap command name for the public runtime surface of this module. */
-export declare function parseBootstrapCommandName(argv: string[]): string | undefined;
-/** Implements apply bootstrap pager policy for the public runtime surface of this module. */
-export declare function applyBootstrapPagerPolicy(argv: string[]): void;
-/** Implements normalize legacy extension action syntax for the public runtime surface of this module. */
-export declare function normalizeLegacyExtensionActionSyntax(argv: string[]): string[];
-type BootstrapNormalizationReason = "legacy_extension_action" | "command_alias" | "flag_alias" | "flag_typo" | "bare_key_value" | "list_merge";
-type BootstrapNormalizationConfidence = "high" | "medium";
-/** Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations. */
-export interface BootstrapNormalizationEvent {
-    /** Value that configures or reports from for this contract. */
-    from: string;
-    /** Value that configures or reports to for this contract. */
-    to: string[];
-    /** Value that configures or reports reason for this contract. */
-    reason: BootstrapNormalizationReason;
-    /** Value that configures or reports confidence for this contract. */
-    confidence: BootstrapNormalizationConfidence;
-}
-/** Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations. */
-export interface BootstrapInvocationNormalizationResult {
-    /** Value that configures or reports argv for this contract. */
-    argv: string[];
-    /** Value that configures or reports command name for this contract. */
-    commandName: string | undefined;
-    /** Value that configures or reports trace for this contract. */
-    trace: BootstrapNormalizationEvent[];
-}
-interface FlagLookup {
-    canonicalByNormalized: Map<string, string | null>;
-    canonicalByCompact: Map<string, string | null>;
-    canonicalComparables: Array<{
-        canonicalFlag: string;
-        comparable: string;
-    }>;
-    listCanonicalFlags: Set<string>;
-}
-declare function markUnambiguousFlag(map: Map<string, string | null>, key: string, canonicalFlag: string): void;
-declare function collectLongFlagCandidates(contract: CliFlagContract): string[];
-declare function buildFlagLookup(commandName: string | undefined, contractsOverride?: CliFlagContract[]): FlagLookup;
-declare function resolveCanonicalFlag(rawKey: string, lookup: FlagLookup): {
-    flag: string;
-    reason: "flag_alias" | "flag_typo";
-    confidence: BootstrapNormalizationConfidence;
-} | null;
-/** Implements list alias plural keys for the public runtime surface of this module. */
-export declare function listAliasPluralKeys(normalizedKey: string): string[];
-declare function normalizeLongOptionToken(token: string, lookup: FlagLookup): {
-    tokens: string[];
-    event?: BootstrapNormalizationEvent;
-};
-/**
- * Coalesce repeated occurrences of comma-separated list flags into a single
- * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,
- * Commander treats these flags as scalars and silently keeps only the last
- * value (data loss). Both `--flag value` and `--flag=value` forms are merged;
- * a value-less occurrence is preserved untouched, and a `--` terminator stops
- * coalescing (remainder is passed through verbatim).
- *
- * `valueConsumingFlags` lists option flags (e.g. global `--path`) whose value
- * may itself begin with `--`. Their value token is emitted verbatim so a
- * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag
- * nor allowed to swallow the following command/positional token.
- */
-export declare function coalesceRepeatedListFlags(argv: string[], listFlags: Set<string>, valueConsumingFlags?: Set<string>, multiValueListFlags?: Set<string>): {
-    argv: string[];
-    events: BootstrapNormalizationEvent[];
-};
-/** Accept the two-token linked-test form `pm test <id> --add command "npm test -- parser"` by merging the bare key token and its single quoted value into the documented `--add command=...` shape. Without this merge Commander binds the bare key as the option value and treats the quoted command as an excess positional, failing with "too many arguments" (GH-191). The merge only fires when EXACTLY ONE non-flag token follows the bare key, i.e. the value was quoted into one shell token — an unquoted multi-token value stays ambiguous (it may swallow the item id), still fails fast, and is routed to targeted quoting guidance by the commander error classifier instead. */
-export declare function mergeLinkedTestTwoTokenEntries(argv: string[], commandName: string | undefined, trace: BootstrapNormalizationEvent[]): string[];
-/** Implements normalize bootstrap invocation for the public runtime surface of this module. */
-export declare function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult;
-/** Implements parse bootstrap type value for the public runtime surface of this module. */
-export declare function parseBootstrapTypeValue(argv: string[]): string | undefined;
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-    buildFlagLookup: typeof buildFlagLookup;
-    collectLongFlagCandidates: typeof collectLongFlagCandidates;
-    markUnambiguousFlag: typeof markUnambiguousFlag;
-    normalizeLongOptionToken: typeof normalizeLongOptionToken;
-    resolveCanonicalFlag: typeof resolveCanonicalFlag;
-};
+export * from "../sdk/cli-bootstrap.js";