npm - @unbrained/pm-cli - Versions diffs - 2026.7.18 → 2026.7.19 - Mend

@unbrained/pm-cli 2026.7.18 → 2026.7.19

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.

Files changed (497) hide show

package/.claude-plugin/marketplace.json CHANGED Viewed

@@ -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.18"
+    "version": "2026.7.19"
   },
   "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.18",
+      "version": "2026.7.19",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,22 @@
 # Changelog
+## 2026.7.19 - 2026-07-19
+### Added
+- Public SDK transaction boundary: atomic multi-item + relationship-event commit primitive ([pm-4e12](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-4e12.toon))
+- Beyond-PM SDK exemplar spike: minimal VCS-style changeset workflow as a pm package (custom schema + event-sourced history + hooks) ([pm-xtrd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-xtrd.toon))
+### Fixed
+- GH-588: pm comment --message exits 0 recording nothing — comment invocation without any comment text must fail fast ([pm-yp56](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-yp56.toon))
+- GH-589: pm next --assignee X answers from anonymous-caller perspective and pm claim conflates assignment with claim ([pm-cj9v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-cj9v.toon))
+- GH-591: pm context agenda events re-embed full item payloads already listed in the same response (~35% of brief output) ([pm-6m1i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-6m1i.toon))
+- GH-592: tracker_not_initialized recovery re-suggests pm init even when a --pm-path tracker exists — following it silently splits workspace state ([pm-tmhs](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-tmhs.toon))
+- GH-586: graph audit severity and code summaries mix finding and affected-item units ([pm-um4g](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-um4g.toon))
+- GH-590: cycle-creating blocked_by mutations succeed silently — items deadlock out of pm next with no inline feedback ([pm-i6pi](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-i6pi.toon))
+- GH-585: extension alias collision diagnostics for core command groups ([pm-v1yo](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-v1yo.toon))
 ## 2026.7.18 - 2026-07-18
 ### Fixed

package/dist/cli/commands/claim.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Implements the pm claim command surface and its agent-facing runtime behavior.
  */
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b0765d0a-904e-5230-a9c3-a4859d07c7ab")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07b1663e-40e3-52cf-99f6-458a651ab229")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { resolveRuntimeStatusRegistry, statusIsTerminal, } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -15,6 +15,7 @@ import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { resolveAuthor } from "../../core/shared/author.js";
 import { wrapOwnershipConflict } from "../../sdk/annotations.js";
+import { describeItemOwnershipConflict } from "../../sdk/ownership-source.js";
 import { runNext } from "./next.js";
 /** Stable warning/error code for an exhausted atomic next-work walk. */
 export const NO_AVAILABLE_NEXT_ITEM_CODE = "no_available_next_item";
@@ -43,7 +44,7 @@ export async function runClaim(id, force, global, options = {}) {
         message: options.message,
         force,
         skipNoop: true,
-        mutate(document) {
+        async mutate(document) {
             const currentAssignee = document.metadata.assignee;
             const currentAssigneeText = typeof currentAssignee === "string" ? currentAssignee : "";
             previousAssignee =
@@ -59,7 +60,8 @@ export async function runClaim(id, force, global, options = {}) {
                 return { changedFields: [] };
             }
             if (heldByOther && !force) {
-                throw new PmCliError(`Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`, EXIT_CODE.CONFLICT, {
+                const ownershipPhrase = await describeItemOwnershipConflict(pmRoot, document.metadata.id, currentAssigneeText);
+                throw new PmCliError(`Item ${document.metadata.id} is already ${ownershipPhrase}. Use --force to take over, or --if-available to skip without failing.`, EXIT_CODE.CONFLICT, {
                     code: "already_claimed_by",
                     why: "Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.",
                     nextSteps: [
@@ -209,4 +211,4 @@ export async function runRelease(id, force, global, options = {}) {
     };
 }
 //# sourceMappingURL=claim.js.map
-//# debugId=b0765d0a-904e-5230-a9c3-a4859d07c7ab
+//# debugId=07b1663e-40e3-52cf-99f6-458a651ab229

package/dist/cli/commands/claim.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module cli/commands/claim\n \n Implements the pm claim command surface and its agent-facing runtime behavior.\n /\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n resolveRuntimeStatusRegistry,\n statusIsTerminal,\n} from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"../../sdk/annotations.js\";\nimport { runNext, type NextRecommendation, type NextOptions } from \"./next.js\";\n\n/* Stable warning/error code for an exhausted atomic next-work walk. /\nexport const NO_AVAILABLE_NEXT_ITEM_CODE = \"no_available_next_item\";\n\n/* Documents the claim result payload exchanged by command, SDK, and package integrations. /\nexport interface ClaimResult {\n /* Value that configures or reports item for this contract. /\n item: Record<string, unknown>;\n /* Value that configures or reports claimed by for this contract. /\n claimed_by: string;\n /* Value that configures or reports previous assignee for this contract. /\n previous_assignee: string \| null;\n /* Value that configures or reports forced for this contract. /\n forced: boolean;\n /* Value that configures or reports skipped for this contract. /\n skipped?: boolean;\n /* Value that configures or reports warnings for this contract. /\n warnings?: string[];\n}\n\n/* Result of atomically selecting and claiming the next caller-available item. /\nexport interface ClaimNextAvailableResult extends ClaimResult {\n /* True when an actionable candidate was claimed. /\n available: true;\n /* Value that configures or reports recommendation for this contract. /\n recommendation: NextRecommendation;\n /* Value that configures or reports attempts for this contract. /\n attempts: number;\n}\n\n/* Non-error empty result returned when an if-available candidate walk is exhausted. /\nexport interface ClaimNextUnavailableResult {\n /* Indicates that no candidate remained claimable. /\n available: false;\n /* Empty item projection for a deliberately unavailable selection. /\n item: null;\n /* Caller identity that attempted the selection. /\n claimed_by: string;\n /* No previous owner exists for an empty selection. /\n previous_assignee: null;\n /* Whether forced selection was requested. /\n forced: boolean;\n /* Signals a deliberate non-error skip. /\n skipped: true;\n /* No recommendation survived the bounded walk. /\n recommendation: null;\n /* Number of ranked candidates attempted. /\n attempts: number;\n /* Stable machine-readable exhaustion warning. /\n warnings: [typeof NO_AVAILABLE_NEXT_ITEM_CODE];\n}\n\n/* Result of a successful or deliberately empty atomic next-work claim. /\nexport type ClaimNextResult =\n \| ClaimNextAvailableResult\n \| ClaimNextUnavailableResult;\n\n/* Returns whether a failed claim lost the atomic test-and-set race. /\nexport function isAlreadyClaimedError(error: unknown): boolean {\n return (\n error instanceof PmCliError && error.context?.code === \"already_claimed_by\"\n );\n}\n\ntype ClaimRunner = (\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions,\n) => Promise<ClaimResult>;\n\n/* Documents the release result payload exchanged by command, SDK, and package integrations. /\nexport interface ReleaseResult {\n /* Value that configures or reports item for this contract. /\n item: Record<string, unknown>;\n /* Value that configures or reports released by for this contract. /\n released_by: string;\n /* Value that configures or reports previous assignee for this contract. /\n previous_assignee: string \| null;\n /* Value that configures or reports forced for this contract. /\n forced: boolean;\n}\n\n/* Documents the claim mutation options payload exchanged by command, SDK, and package integrations. /\nexport interface ClaimMutationOptions {\n /* Value that configures or reports author for this contract. /\n author?: string;\n /* Human-readable explanation suitable for logs and agent-facing output. /\n message?: string;\n /* Value that configures or reports if available for this contract. /\n ifAvailable?: boolean;\n /* Maximum ranked candidates attempted by `claim --next`. /\n maxAttempts?: string \| number;\n}\n\n/* Documents the release mutation options payload exchanged by command, SDK, and package integrations. /\nexport type ReleaseMutationOptions = ClaimMutationOptions;\n\n/* Implements run claim for the public runtime surface of this module. /\nexport async function runClaim(\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\n const pmRoot = resolvePmRoot(process.cwd(), global.path);\n if (!(await pathExists(getSettingsPath(pmRoot)))) {\n throw new PmCliError(\n `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n EXIT_CODE.NOT_FOUND,\n );\n }\n const settings = await readSettings(pmRoot);\n const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n const author = resolveAuthor(options.author, settings.author_default);\n let previousAssignee: string \| null = null;\n let skipped = false;\n const mutationWarnings: string[] = [];\n\n const result = await mutateItem({\n pmRoot,\n settings,\n id,\n op: \"claim\",\n author,\n message: options.message,\n force,\n skipNoop: true,\n mutate(document) {\n const currentAssignee = document.metadata.assignee;\n const currentAssigneeText =\n typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n previousAssignee =\n currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n if (\n statusIsTerminal(document.metadata.status, statusRegistry) &&\n !force\n ) {\n throw new PmCliError(\n `Cannot claim terminal item ${document.metadata.id} without --force`,\n EXIT_CODE.CONFLICT,\n );\n }\n const heldByOther =\n previousAssignee !== null && previousAssignee !== author;\n if (heldByOther && options.ifAvailable === true) {\n skipped = true;\n mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n return { changedFields: [] };\n }\n if (heldByOther && !force) {\n throw new PmCliError(\n `Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`,\n EXIT_CODE.CONFLICT,\n {\n code: \"already_claimed_by\",\n why: \"Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.\",\n nextSteps: [\n \"Run pm next to pick a different unclaimed item.\",\n \"Re-run with --if-available to treat a held item as a no-op skip.\",\n \"Re-run with --force only when taking over the item is coordinated.\",\n ],\n },\n );\n }\n if (heldByOther) {\n mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n }\n document.metadata.assignee = author;\n return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n },\n });\n\n return {\n item: toItemRecord(result.item),\n claimed_by:\n skipped && previousAssignee !== null ? previousAssignee : author,\n previous_assignee: previousAssignee,\n forced: force,\n ...(skipped ? { skipped: true } : {}),\n ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n };\n}\n\n/* Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. /\nexport async function runClaimNext(\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n nextOptions: NextOptions = {},\n): Promise<ClaimNextResult> {\n const maxAttempts = parseClaimNextAttempts(options.maxAttempts);\n const settings = await readSettings(resolvePmRoot(process.cwd(), global.path));\n const claimOptions = {\n ...options,\n author: resolveAuthor(options.author, settings.author_default),\n };\n const next = await runNext(\n {\n ...nextOptions,\n callerAuthor: claimOptions.author,\n limit: String(maxAttempts),\n },\n global,\n );\n const recommendations = [next.recommended, ...next.ready]\n .filter((entry): entry is NextRecommendation => entry !== null)\n .map((entry) => ({\n ...entry,\n reasons: \"reasons\" in entry ? entry.reasons : [\"ranked ready candidate\"],\n }));\n return claimNextFromRecommendations(\n recommendations.slice(0, maxAttempts),\n force,\n global,\n claimOptions,\n );\n}\n\n/* Parses the bounded candidate walk used by `claim --next`. /\nexport function parseClaimNextAttempts(raw: string \| number \| undefined): number {\n if (raw === undefined) return 10;\n const parsed = Number(raw);\n if (!Number.isSafeInteger(parsed) \|\| parsed < 1 \|\| parsed > 100) {\n throw new PmCliError(\n \"--max-attempts must be an integer from 1 to 100\",\n EXIT_CODE.USAGE,\n );\n }\n return parsed;\n}\n\n/* Claims the first still-available row from a pre-ranked recommendation set. /\nexport async function claimNextFromRecommendations(\n recommendations: NextRecommendation[],\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n claimRunner: ClaimRunner = runClaim,\n): Promise<ClaimNextResult> {\n let attempts = 0;\n for (const recommendation of recommendations) {\n attempts += 1;\n try {\n const claimed = await claimRunner(\n recommendation.id,\n force,\n global,\n options,\n );\n const result = { ...claimed, recommendation, attempts, available: true as const };\n if (!claimed.skipped) return result;\n } catch (error: unknown) {\n if (!isAlreadyClaimedError(error)) throw error;\n }\n }\n if (options.ifAvailable === true) {\n return {\n available: false,\n item: null,\n claimed_by: options.author ?? process.env.PM_AUTHOR ?? \"unknown\",\n previous_assignee: null,\n forced: force,\n skipped: true,\n recommendation: null,\n attempts,\n warnings: [NO_AVAILABLE_NEXT_ITEM_CODE],\n };\n }\n const noCandidatesMatched = attempts === 0;\n throw new PmCliError(\n noCandidatesMatched\n ? \"No actionable items matched the selection filters\"\n : \"No actionable item remained available to claim\",\n noCandidatesMatched ? EXIT_CODE.NOT_FOUND : EXIT_CODE.CONFLICT,\n {\n code: NO_AVAILABLE_NEXT_ITEM_CODE,\n why: noCandidatesMatched\n ? \"No ready items matched the specified filters or selection criteria.\"\n : \"Every ranked candidate was claimed by another agent before this atomic selection completed.\",\n nextSteps: [\n noCandidatesMatched\n ? \"Verify the filters or run pm next to inspect all ready work.\"\n : \"Run pm claim --next again to refresh the ranked candidate set.\",\n ],\n },\n );\n}\n\n/* Implements run release for the public runtime surface of this module. */\nexport async function runRelease(\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\n const pmRoot = resolvePmRoot(process.cwd(), global.path);\n if (!(await pathExists(getSettingsPath(pmRoot)))) {\n throw new PmCliError(\n `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n EXIT_CODE.NOT_FOUND,\n );\n }\n const settings = await readSettings(pmRoot);\n const author = resolveAuthor(options.author, settings.author_default);\n const ownershipReleaseBypass =\n (options as ReleaseMutationOptions & {\n ownershipReleaseBypass?: boolean;\n }).ownershipReleaseBypass === true;\n let previousAssignee: string \| null = null;\n\n let result: Awaited<ReturnType<typeof mutateItem>>;\n try {\n result = await mutateItem({\n pmRoot,\n settings,\n id,\n op: \"release\",\n author,\n message: options.message,\n force,\n bypassAssigneeConflict: ownershipReleaseBypass,\n mutate(document) {\n previousAssignee = document.metadata.assignee ?? null;\n if (!previousAssignee) {\n return { changedFields: [] };\n }\n delete document.metadata.assignee;\n return { changedFields: [\"assignee\"] };\n },\n });\n } catch (error: unknown) {\n wrapOwnershipConflict(error, {\n required:\n \"For approved non-owner handoffs, prefer the ownership-release bypass before considering --force.\",\n examples: ['pm release pm-a1b2 --author \"reviewer\" --force'],\n nextSteps: [\n \"Use the package-provided ownership-release bypass for handoffs that only clear assignee metadata.\",\n \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n ],\n });\n }\n\n return {\n item: toItemRecord(result.item),\n released_by: author,\n previous_assignee: previousAssignee,\n forced: force,\n };\n}\n"],"names":[],"mappings":"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","debugId":"b0765d0a-904e-5230-a9c3-a4859d07c7ab"}
1	+ {"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module cli/commands/claim\n \n Implements the pm claim command surface and its agent-facing runtime behavior.\n /\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n resolveRuntimeStatusRegistry,\n statusIsTerminal,\n} from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"../../sdk/annotations.js\";\nimport { describeItemOwnershipConflict } from \"../../sdk/ownership-source.js\";\nimport { runNext, type NextRecommendation, type NextOptions } from \"./next.js\";\n\n/* Stable warning/error code for an exhausted atomic next-work walk. /\nexport const NO_AVAILABLE_NEXT_ITEM_CODE = \"no_available_next_item\";\n\n/* Documents the claim result payload exchanged by command, SDK, and package integrations. /\nexport interface ClaimResult {\n /* Value that configures or reports item for this contract. /\n item: Record<string, unknown>;\n /* Value that configures or reports claimed by for this contract. /\n claimed_by: string;\n /* Value that configures or reports previous assignee for this contract. /\n previous_assignee: string \| null;\n /* Value that configures or reports forced for this contract. /\n forced: boolean;\n /* Value that configures or reports skipped for this contract. /\n skipped?: boolean;\n /* Value that configures or reports warnings for this contract. /\n warnings?: string[];\n}\n\n/* Result of atomically selecting and claiming the next caller-available item. /\nexport interface ClaimNextAvailableResult extends ClaimResult {\n /* True when an actionable candidate was claimed. /\n available: true;\n /* Value that configures or reports recommendation for this contract. /\n recommendation: NextRecommendation;\n /* Value that configures or reports attempts for this contract. /\n attempts: number;\n}\n\n/* Non-error empty result returned when an if-available candidate walk is exhausted. /\nexport interface ClaimNextUnavailableResult {\n /* Indicates that no candidate remained claimable. /\n available: false;\n /* Empty item projection for a deliberately unavailable selection. /\n item: null;\n /* Caller identity that attempted the selection. /\n claimed_by: string;\n /* No previous owner exists for an empty selection. /\n previous_assignee: null;\n /* Whether forced selection was requested. /\n forced: boolean;\n /* Signals a deliberate non-error skip. /\n skipped: true;\n /* No recommendation survived the bounded walk. /\n recommendation: null;\n /* Number of ranked candidates attempted. /\n attempts: number;\n /* Stable machine-readable exhaustion warning. /\n warnings: [typeof NO_AVAILABLE_NEXT_ITEM_CODE];\n}\n\n/* Result of a successful or deliberately empty atomic next-work claim. /\nexport type ClaimNextResult =\n \| ClaimNextAvailableResult\n \| ClaimNextUnavailableResult;\n\n/* Returns whether a failed claim lost the atomic test-and-set race. /\nexport function isAlreadyClaimedError(error: unknown): boolean {\n return (\n error instanceof PmCliError && error.context?.code === \"already_claimed_by\"\n );\n}\n\ntype ClaimRunner = (\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions,\n) => Promise<ClaimResult>;\n\n/* Documents the release result payload exchanged by command, SDK, and package integrations. /\nexport interface ReleaseResult {\n /* Value that configures or reports item for this contract. /\n item: Record<string, unknown>;\n /* Value that configures or reports released by for this contract. /\n released_by: string;\n /* Value that configures or reports previous assignee for this contract. /\n previous_assignee: string \| null;\n /* Value that configures or reports forced for this contract. /\n forced: boolean;\n}\n\n/* Documents the claim mutation options payload exchanged by command, SDK, and package integrations. /\nexport interface ClaimMutationOptions {\n /* Value that configures or reports author for this contract. /\n author?: string;\n /* Human-readable explanation suitable for logs and agent-facing output. /\n message?: string;\n /* Value that configures or reports if available for this contract. /\n ifAvailable?: boolean;\n /* Maximum ranked candidates attempted by `claim --next`. /\n maxAttempts?: string \| number;\n}\n\n/* Documents the release mutation options payload exchanged by command, SDK, and package integrations. /\nexport type ReleaseMutationOptions = ClaimMutationOptions;\n\n/* Implements run claim for the public runtime surface of this module. /\nexport async function runClaim(\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\n const pmRoot = resolvePmRoot(process.cwd(), global.path);\n if (!(await pathExists(getSettingsPath(pmRoot)))) {\n throw new PmCliError(\n `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n EXIT_CODE.NOT_FOUND,\n );\n }\n const settings = await readSettings(pmRoot);\n const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n const author = resolveAuthor(options.author, settings.author_default);\n let previousAssignee: string \| null = null;\n let skipped = false;\n const mutationWarnings: string[] = [];\n\n const result = await mutateItem({\n pmRoot,\n settings,\n id,\n op: \"claim\",\n author,\n message: options.message,\n force,\n skipNoop: true,\n async mutate(document) {\n const currentAssignee = document.metadata.assignee;\n const currentAssigneeText =\n typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n previousAssignee =\n currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n if (\n statusIsTerminal(document.metadata.status, statusRegistry) &&\n !force\n ) {\n throw new PmCliError(\n `Cannot claim terminal item ${document.metadata.id} without --force`,\n EXIT_CODE.CONFLICT,\n );\n }\n const heldByOther =\n previousAssignee !== null && previousAssignee !== author;\n if (heldByOther && options.ifAvailable === true) {\n skipped = true;\n mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n return { changedFields: [] };\n }\n if (heldByOther && !force) {\n const ownershipPhrase = await describeItemOwnershipConflict(\n pmRoot,\n document.metadata.id,\n currentAssigneeText,\n );\n throw new PmCliError(\n `Item ${document.metadata.id} is already ${ownershipPhrase}. Use --force to take over, or --if-available to skip without failing.`,\n EXIT_CODE.CONFLICT,\n {\n code: \"already_claimed_by\",\n why: \"Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.\",\n nextSteps: [\n \"Run pm next to pick a different unclaimed item.\",\n \"Re-run with --if-available to treat a held item as a no-op skip.\",\n \"Re-run with --force only when taking over the item is coordinated.\",\n ],\n },\n );\n }\n if (heldByOther) {\n mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n }\n document.metadata.assignee = author;\n return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n },\n });\n\n return {\n item: toItemRecord(result.item),\n claimed_by:\n skipped && previousAssignee !== null ? previousAssignee : author,\n previous_assignee: previousAssignee,\n forced: force,\n ...(skipped ? { skipped: true } : {}),\n ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n };\n}\n\n/* Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. /\nexport async function runClaimNext(\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n nextOptions: NextOptions = {},\n): Promise<ClaimNextResult> {\n const maxAttempts = parseClaimNextAttempts(options.maxAttempts);\n const settings = await readSettings(resolvePmRoot(process.cwd(), global.path));\n const claimOptions = {\n ...options,\n author: resolveAuthor(options.author, settings.author_default),\n };\n const next = await runNext(\n {\n ...nextOptions,\n callerAuthor: claimOptions.author,\n limit: String(maxAttempts),\n },\n global,\n );\n const recommendations = [next.recommended, ...next.ready]\n .filter((entry): entry is NextRecommendation => entry !== null)\n .map((entry) => ({\n ...entry,\n reasons: \"reasons\" in entry ? entry.reasons : [\"ranked ready candidate\"],\n }));\n return claimNextFromRecommendations(\n recommendations.slice(0, maxAttempts),\n force,\n global,\n claimOptions,\n );\n}\n\n/* Parses the bounded candidate walk used by `claim --next`. /\nexport function parseClaimNextAttempts(raw: string \| number \| undefined): number {\n if (raw === undefined) return 10;\n const parsed = Number(raw);\n if (!Number.isSafeInteger(parsed) \|\| parsed < 1 \|\| parsed > 100) {\n throw new PmCliError(\n \"--max-attempts must be an integer from 1 to 100\",\n EXIT_CODE.USAGE,\n );\n }\n return parsed;\n}\n\n/* Claims the first still-available row from a pre-ranked recommendation set. /\nexport async function claimNextFromRecommendations(\n recommendations: NextRecommendation[],\n force: boolean,\n global: GlobalOptions,\n options: ClaimMutationOptions = {},\n claimRunner: ClaimRunner = runClaim,\n): Promise<ClaimNextResult> {\n let attempts = 0;\n for (const recommendation of recommendations) {\n attempts += 1;\n try {\n const claimed = await claimRunner(\n recommendation.id,\n force,\n global,\n options,\n );\n const result = { ...claimed, recommendation, attempts, available: true as const };\n if (!claimed.skipped) return result;\n } catch (error: unknown) {\n if (!isAlreadyClaimedError(error)) throw error;\n }\n }\n if (options.ifAvailable === true) {\n return {\n available: false,\n item: null,\n claimed_by: options.author ?? process.env.PM_AUTHOR ?? \"unknown\",\n previous_assignee: null,\n forced: force,\n skipped: true,\n recommendation: null,\n attempts,\n warnings: [NO_AVAILABLE_NEXT_ITEM_CODE],\n };\n }\n const noCandidatesMatched = attempts === 0;\n throw new PmCliError(\n noCandidatesMatched\n ? \"No actionable items matched the selection filters\"\n : \"No actionable item remained available to claim\",\n noCandidatesMatched ? EXIT_CODE.NOT_FOUND : EXIT_CODE.CONFLICT,\n {\n code: NO_AVAILABLE_NEXT_ITEM_CODE,\n why: noCandidatesMatched\n ? \"No ready items matched the specified filters or selection criteria.\"\n : \"Every ranked candidate was claimed by another agent before this atomic selection completed.\",\n nextSteps: [\n noCandidatesMatched\n ? \"Verify the filters or run pm next to inspect all ready work.\"\n : \"Run pm claim --next again to refresh the ranked candidate set.\",\n ],\n },\n );\n}\n\n/* Implements run release for the public runtime surface of this module. */\nexport async function runRelease(\n id: string,\n force: boolean,\n global: GlobalOptions,\n options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\n const pmRoot = resolvePmRoot(process.cwd(), global.path);\n if (!(await pathExists(getSettingsPath(pmRoot)))) {\n throw new PmCliError(\n `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n EXIT_CODE.NOT_FOUND,\n );\n }\n const settings = await readSettings(pmRoot);\n const author = resolveAuthor(options.author, settings.author_default);\n const ownershipReleaseBypass =\n (options as ReleaseMutationOptions & {\n ownershipReleaseBypass?: boolean;\n }).ownershipReleaseBypass === true;\n let previousAssignee: string \| null = null;\n\n let result: Awaited<ReturnType<typeof mutateItem>>;\n try {\n result = await mutateItem({\n pmRoot,\n settings,\n id,\n op: \"release\",\n author,\n message: options.message,\n force,\n bypassAssigneeConflict: ownershipReleaseBypass,\n mutate(document) {\n previousAssignee = document.metadata.assignee ?? null;\n if (!previousAssignee) {\n return { changedFields: [] };\n }\n delete document.metadata.assignee;\n return { changedFields: [\"assignee\"] };\n },\n });\n } catch (error: unknown) {\n wrapOwnershipConflict(error, {\n required:\n \"For approved non-owner handoffs, prefer the ownership-release bypass before considering --force.\",\n examples: ['pm release pm-a1b2 --author \"reviewer\" --force'],\n nextSteps: [\n \"Use the package-provided ownership-release bypass for handoffs that only clear assignee metadata.\",\n \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n ],\n });\n }\n\n return {\n item: toItemRecord(result.item),\n released_by: author,\n previous_assignee: previousAssignee,\n forced: force,\n };\n}\n"],"names":[],"mappings":"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","debugId":"07b1663e-40e3-52cf-99f6-458a651ab229"}

package/dist/cli/commands/comments.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Implements the pm comments command surface and its agent-facing runtime behavior.
  */
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8ce260ec-649b-50b7-ac63-c848f47c5e83")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b3b32185-9c56-5f47-843d-1181bd71f230")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -95,6 +95,9 @@ async function resolveCommentInput(options, stdinResolver) {
 export async function runComments(id, options, global) {
     const stdinResolver = createStdinTokenResolver();
     const commentInput = await resolveCommentInput(options, stdinResolver);
+    if (commentInput.mode === "list" && options.message !== undefined) {
+        throw new PmCliError("--message labels a comment mutation but does not provide comment text. Pass text positionally or with --add, --stdin, or --file.", EXIT_CODE.USAGE);
+    }
     const shouldParseText = commentInput.mode === "add" || commentInput.mode === "edit";
     const rawValue = commentInput.value ?? "";
     return runAnnotationCommand(id, options, global, {
@@ -123,4 +126,4 @@ export async function runComments(id, options, global) {
     });
 }
 //# sourceMappingURL=comments.js.map
-//# debugId=8ce260ec-649b-50b7-ac63-c848f47c5e83
+//# debugId=b3b32185-9c56-5f47-843d-1181bd71f230

package/dist/cli/commands/comments.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"comments.js","sources":["cli/commands/comments.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module cli/commands/comments\n \n Implements the pm comments command surface and its agent-facing runtime behavior.\n /\nimport { readFile } from \"node:fs/promises\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport {\n isErrnoError,\n parseAnnotationTextInput,\n runAnnotationCommand,\n} from \"../../sdk/annotations.js\";\n\n/* Documents the comments command options payload exchanged by command, SDK, and package integrations. /\nexport interface CommentsCommandOptions {\n /* Value that configures or reports add for this contract. /\n add?: string;\n /* Value that configures or reports stdin for this contract. /\n stdin?: boolean;\n /* Value that configures or reports file for this contract. /\n file?: string;\n /* Value that configures or reports edit for this contract. /\n edit?: number;\n /* Value that configures or reports delete for this contract. /\n delete?: number;\n /* Value that configures or reports limit for this contract. /\n limit?: string;\n /* Value that configures or reports include meta for this contract. /\n includeMeta?: boolean;\n /* Value that configures or reports author for this contract. /\n author?: string;\n /* Human-readable explanation suitable for logs and agent-facing output. /\n message?: string;\n /* Value that configures or reports force for this contract. /\n force?: boolean;\n}\n\n/* Documents the comments result payload exchanged by command, SDK, and package integrations. /\nexport interface CommentsResult {\n /* Stable identifier used to reference this record across commands and storage. /\n id: string;\n /* Value that configures or reports comments for this contract. /\n comments: Comment[];\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Number of total entries represented by this result. /\n total_count?: number;\n /* Number of returned entries represented by this result. /\n returned_count?: number;\n /* Whether more applies to this operation. /\n has_more?: boolean;\n /* Value that configures or reports limit for this contract. /\n limit?: number;\n}\n\ninterface ResolvedCommentInput {\n mode: \"list\" \| \"add\" \| \"stdin\" \| \"file\" \| \"edit\" \| \"delete\";\n value?: string;\n emptyFlag?: string;\n index?: number;\n}\n\nasync function resolveCommentTextSource(\n options: CommentsCommandOptions,\n stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } \| undefined> {\n const hasAdd = options.add !== undefined;\n const hasStdin = options.stdin === true;\n const hasFile = typeof options.file === \"string\";\n const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n if (sourceCount === 0) {\n return undefined;\n }\n if (sourceCount > 1) {\n throw new PmCliError(\n \"Specify comment text using only one input source: --add, --stdin, or --file\",\n EXIT_CODE.USAGE,\n );\n }\n if (hasAdd) {\n const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n }\n if (hasStdin) {\n const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n }\n const filePath = (options.file as string).trim();\n if (!filePath) {\n throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n }\n try {\n const fileInput = await readFile(filePath, \"utf8\");\n return { value: fileInput, emptyFlag: \"--file\" };\n } catch (error: unknown) {\n if (isErrnoError(error) && error.code === \"ENOENT\") {\n throw new PmCliError(\n `--file path not found: ${filePath}`,\n EXIT_CODE.USAGE,\n );\n }\n const detail = error instanceof Error ? error.message : String(error);\n throw new PmCliError(\n `Failed to read --file path \"${filePath}\": ${detail}`,\n EXIT_CODE.USAGE,\n );\n }\n}\n\nasync function resolveCommentInput(\n options: CommentsCommandOptions,\n stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n const editIndex = options.edit;\n const deleteIndex = options.delete;\n const hasEdit = editIndex !== undefined;\n const hasDelete = deleteIndex !== undefined;\n if (hasEdit && hasDelete) {\n throw new PmCliError(\n \"Specify only one of --edit or --delete\",\n EXIT_CODE.USAGE,\n );\n }\n if (editIndex !== undefined && (!Number.isInteger(editIndex) \|\| editIndex < 1)) {\n throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n }\n if (deleteIndex !== undefined && (!Number.isInteger(deleteIndex) \|\| deleteIndex < 1)) {\n throw new PmCliError(\"--delete must be a positive integer\", EXIT_CODE.USAGE);\n }\n\n if (hasDelete) {\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource !== undefined) {\n throw new PmCliError(\n \"--delete does not take comment text\",\n EXIT_CODE.USAGE,\n );\n }\n return { mode: \"delete\", index: deleteIndex };\n }\n\n if (hasEdit) {\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource === undefined) {\n throw new PmCliError(\n \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n EXIT_CODE.USAGE,\n );\n }\n return {\n mode: \"edit\",\n index: editIndex,\n value: textSource.value,\n emptyFlag: textSource.emptyFlag,\n };\n }\n\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource === undefined) {\n return { mode: \"list\" };\n }\n // Map the single resolved input source back to its add/stdin/file mode so the\n // caller still knows whether to run plain-text markdown parsing (add-only).\n const mode =\n textSource.emptyFlag === \"--add\"\n ? \"add\"\n : textSource.emptyFlag === \"--stdin\"\n ? \"stdin\"\n : \"file\";\n return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/* Implements run comments for the public runtime surface of this module. */\nexport async function runComments(\n id: string,\n options: CommentsCommandOptions,\n global: GlobalOptions,\n): Promise<CommentsResult> {\n const stdinResolver = createStdinTokenResolver();\n const commentInput = await resolveCommentInput(options, stdinResolver);\n\n const shouldParseText =\n commentInput.mode === \"add\" \|\| commentInput.mode === \"edit\";\n const rawValue = commentInput.value ?? \"\";\n return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n input: {\n ...commentInput,\n rawValue: options.add ?? rawValue,\n value: shouldParseText\n ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true })\n : rawValue,\n },\n collectionKey: \"comments\",\n op: \"comment_add\",\n editOp: \"comment_edit\",\n deleteOp: \"comment_delete\",\n parseText: (raw) => raw,\n bypassOwnershipConflict: Boolean(\n commentInput.mode === \"add\" &&\n (options as CommentsCommandOptions & {\n ownershipAppendBypass?: boolean;\n }).ownershipAppendBypass,\n ),\n conflictGuidance: {\n required:\n \"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.\",\n examples: ['pm comments pm-a1b2 --add \"review note\" --author \"reviewer\" --force'],\n nextSteps: [\n \"Use an installed package's narrow append-only ownership bypass when available.\",\n \"Use --force only when an ownership override is explicitly approved.\",\n ],\n },\n });\n}\n"],"names":[],"mappings":"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","debugId":"8ce260ec-649b-50b7-ac63-c848f47c5e83"}
1	+ {"version":3,"file":"comments.js","sources":["cli/commands/comments.ts"],"sourceRoot":"/","sourcesContent":["/*\n @module cli/commands/comments\n \n Implements the pm comments command surface and its agent-facing runtime behavior.\n /\nimport { readFile } from \"node:fs/promises\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport {\n isErrnoError,\n parseAnnotationTextInput,\n runAnnotationCommand,\n} from \"../../sdk/annotations.js\";\n\n/* Documents the comments command options payload exchanged by command, SDK, and package integrations. /\nexport interface CommentsCommandOptions {\n /* Value that configures or reports add for this contract. /\n add?: string;\n /* Value that configures or reports stdin for this contract. /\n stdin?: boolean;\n /* Value that configures or reports file for this contract. /\n file?: string;\n /* Value that configures or reports edit for this contract. /\n edit?: number;\n /* Value that configures or reports delete for this contract. /\n delete?: number;\n /* Value that configures or reports limit for this contract. /\n limit?: string;\n /* Value that configures or reports include meta for this contract. /\n includeMeta?: boolean;\n /* Value that configures or reports author for this contract. /\n author?: string;\n /* Human-readable explanation suitable for logs and agent-facing output. /\n message?: string;\n /* Value that configures or reports force for this contract. /\n force?: boolean;\n}\n\n/* Documents the comments result payload exchanged by command, SDK, and package integrations. /\nexport interface CommentsResult {\n /* Stable identifier used to reference this record across commands and storage. /\n id: string;\n /* Value that configures or reports comments for this contract. /\n comments: Comment[];\n /* Value that configures or reports count for this contract. /\n count: number;\n /* Number of total entries represented by this result. /\n total_count?: number;\n /* Number of returned entries represented by this result. /\n returned_count?: number;\n /* Whether more applies to this operation. /\n has_more?: boolean;\n /* Value that configures or reports limit for this contract. /\n limit?: number;\n}\n\ninterface ResolvedCommentInput {\n mode: \"list\" \| \"add\" \| \"stdin\" \| \"file\" \| \"edit\" \| \"delete\";\n value?: string;\n emptyFlag?: string;\n index?: number;\n}\n\nasync function resolveCommentTextSource(\n options: CommentsCommandOptions,\n stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } \| undefined> {\n const hasAdd = options.add !== undefined;\n const hasStdin = options.stdin === true;\n const hasFile = typeof options.file === \"string\";\n const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n if (sourceCount === 0) {\n return undefined;\n }\n if (sourceCount > 1) {\n throw new PmCliError(\n \"Specify comment text using only one input source: --add, --stdin, or --file\",\n EXIT_CODE.USAGE,\n );\n }\n if (hasAdd) {\n const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n }\n if (hasStdin) {\n const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n }\n const filePath = (options.file as string).trim();\n if (!filePath) {\n throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n }\n try {\n const fileInput = await readFile(filePath, \"utf8\");\n return { value: fileInput, emptyFlag: \"--file\" };\n } catch (error: unknown) {\n if (isErrnoError(error) && error.code === \"ENOENT\") {\n throw new PmCliError(\n `--file path not found: ${filePath}`,\n EXIT_CODE.USAGE,\n );\n }\n const detail = error instanceof Error ? error.message : String(error);\n throw new PmCliError(\n `Failed to read --file path \"${filePath}\": ${detail}`,\n EXIT_CODE.USAGE,\n );\n }\n}\n\nasync function resolveCommentInput(\n options: CommentsCommandOptions,\n stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n const editIndex = options.edit;\n const deleteIndex = options.delete;\n const hasEdit = editIndex !== undefined;\n const hasDelete = deleteIndex !== undefined;\n if (hasEdit && hasDelete) {\n throw new PmCliError(\n \"Specify only one of --edit or --delete\",\n EXIT_CODE.USAGE,\n );\n }\n if (editIndex !== undefined && (!Number.isInteger(editIndex) \|\| editIndex < 1)) {\n throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n }\n if (deleteIndex !== undefined && (!Number.isInteger(deleteIndex) \|\| deleteIndex < 1)) {\n throw new PmCliError(\"--delete must be a positive integer\", EXIT_CODE.USAGE);\n }\n\n if (hasDelete) {\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource !== undefined) {\n throw new PmCliError(\n \"--delete does not take comment text\",\n EXIT_CODE.USAGE,\n );\n }\n return { mode: \"delete\", index: deleteIndex };\n }\n\n if (hasEdit) {\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource === undefined) {\n throw new PmCliError(\n \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n EXIT_CODE.USAGE,\n );\n }\n return {\n mode: \"edit\",\n index: editIndex,\n value: textSource.value,\n emptyFlag: textSource.emptyFlag,\n };\n }\n\n const textSource = await resolveCommentTextSource(options, stdinResolver);\n if (textSource === undefined) {\n return { mode: \"list\" };\n }\n // Map the single resolved input source back to its add/stdin/file mode so the\n // caller still knows whether to run plain-text markdown parsing (add-only).\n const mode =\n textSource.emptyFlag === \"--add\"\n ? \"add\"\n : textSource.emptyFlag === \"--stdin\"\n ? \"stdin\"\n : \"file\";\n return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/* Implements run comments for the public runtime surface of this module. */\nexport async function runComments(\n id: string,\n options: CommentsCommandOptions,\n global: GlobalOptions,\n): Promise<CommentsResult> {\n const stdinResolver = createStdinTokenResolver();\n const commentInput = await resolveCommentInput(options, stdinResolver);\n if (commentInput.mode === \"list\" && options.message !== undefined) {\n throw new PmCliError(\n \"--message labels a comment mutation but does not provide comment text. Pass text positionally or with --add, --stdin, or --file.\",\n EXIT_CODE.USAGE,\n );\n }\n\n const shouldParseText =\n commentInput.mode === \"add\" \|\| commentInput.mode === \"edit\";\n const rawValue = commentInput.value ?? \"\";\n return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n input: {\n ...commentInput,\n rawValue: options.add ?? rawValue,\n value: shouldParseText\n ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true })\n : rawValue,\n },\n collectionKey: \"comments\",\n op: \"comment_add\",\n editOp: \"comment_edit\",\n deleteOp: \"comment_delete\",\n parseText: (raw) => raw,\n bypassOwnershipConflict: Boolean(\n commentInput.mode === \"add\" &&\n (options as CommentsCommandOptions & {\n ownershipAppendBypass?: boolean;\n }).ownershipAppendBypass,\n ),\n conflictGuidance: {\n required:\n \"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.\",\n examples: ['pm comments pm-a1b2 --add \"review note\" --author \"reviewer\" --force'],\n nextSteps: [\n \"Use an installed package's narrow append-only ownership bypass when available.\",\n \"Use --force only when an ownership override is explicitly approved.\",\n ],\n },\n });\n}\n"],"names":[],"mappings":"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","debugId":"b3b32185-9c56-5f47-843d-1181bd71f230"}

package/dist/cli/commands/context.d.ts CHANGED Viewed

@@ -89,6 +89,13 @@ export interface ContextFocusItem {
     /** Value that configures or reports completion pct for this contract. */
     completion_pct?: number;
 }
+/** Compact agenda reference used when the corresponding item is already present in a focus section. */
+export type ContextAgendaEvent = CalendarRow | (Pick<CalendarRow, "at" | "date" | "kind" | "item_id"> & {
+    reference_only: true;
+    reminder_text?: string | null;
+    event_title?: string | null;
+    event_recurring?: boolean | null;
+});
 /** Documents the hierarchy child payload exchanged by command, SDK, and package integrations. */
 export interface HierarchyChild {
     /** Stable identifier used to reference this record across commands and storage. */
@@ -281,7 +288,7 @@ export interface ContextResult {
     /** Value that configures or reports agenda for this contract. */
     agenda: {
         summary: ContextAgendaSummary;
-        events: CalendarRow[];
+        events: ContextAgendaEvent[];
     };
     /** Value that configures or reports hierarchy for this contract. */
     hierarchy?: HierarchyNode[];
@@ -435,6 +442,7 @@ export declare const _testOnly: {
     completionPct: typeof completionPct;
     dateTokenForTimestamp: typeof dateTokenForTimestamp;
     filterTerminalCalendarEvents: typeof filterTerminalCalendarEvents;
+    formatAgendaLine: typeof formatAgendaLine;
     isBlockedStatus: typeof isBlockedStatus;
     isClosedStatus: typeof isClosedStatus;
     isInProgressStatus: typeof isInProgressStatus;
@@ -462,6 +470,7 @@ declare function buildStaleness(allNonTerminal: ItemMetadata[], staleThresholdDa
 declare function buildRecentlyCreated(allNonTerminal: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, childrenByParent: Map<string, ItemMetadata[]>, limit: number): RecentContextItem[];
 declare function buildUnparented(allNonTerminal: ItemMetadata[], statusRegistry: RuntimeStatusRegistry, childrenByParent: Map<string, ItemMetadata[]>, limit: number): ContextFocusItem[];
 declare function buildTestHealth(activeItems: ItemMetadata[]): TestHealthSummary;
+declare function formatAgendaLine(event: ContextAgendaEvent): string;
 /** Implements render context markdown for the public runtime surface of this module. */
 export declare function renderContextMarkdown(result: ContextResult): string;
 /** Implements run context for the public runtime surface of this module. */

package/dist/cli/commands/context.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Implements the pm context command surface and its agent-facing runtime behavior.
  */
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2df694f8-45bb-5a5c-aea9-30da2ed1633d")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="73237ae4-dd9f-5a67-9053-b2ffed05b1cf")}catch(e){}}();
 import { SETTINGS_DEFAULTS, EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { compareTimestampStrings, nowIso } from "../../core/shared/time.js";
@@ -634,6 +634,7 @@ export const _testOnly = {
     completionPct,
     dateTokenForTimestamp,
     filterTerminalCalendarEvents,
+    formatAgendaLine,
     isBlockedStatus,
     isClosedStatus,
     isInProgressStatus,
@@ -869,6 +870,14 @@ function formatProjectedFocusLine(item, fields) {
         .join(" ");
 }
 function formatAgendaLine(event) {
+    if ("reference_only" in event) {
+        const suffix = event.kind === "reminder"
+            ? ` — ${event.reminder_text ?? "reminder"}`
+            : event.kind === "event"
+                ? ` — ${event.event_title ?? "event"}${event.event_recurring ? " (recurring)" : ""}`
+                : "";
+        return `${formatClock(event.at)} [${event.kind}] ${event.item_id} (see focus item)${suffix}`;
+    }
     const base = `${formatClock(event.at)} [${event.kind}] ${event.item_id} p${event.item_priority} ${event.item_status} ${event.item_title}`;
     if (event.kind === "reminder") {
         return `${base} — ${event.reminder_text}`;
@@ -1256,7 +1265,7 @@ function shouldPageContextFocus(options, corpusItemCount) {
         options.after !== undefined ||
         corpusItemCount >= CONTEXT_SCALE_THRESHOLD);
 }
-async function buildContextAgenda(options, global, runtime, subtreeIds) {
+async function buildContextAgenda(options, global, runtime, subtreeIds, listedFocusIds) {
     const calendarOptions = {
         ...runtime.baseListOptions,
         view: "agenda",
@@ -1267,8 +1276,33 @@ async function buildContextAgenda(options, global, runtime, subtreeIds) {
     const scopedAgenda = subtreeIds === undefined
         ? agenda.events
         : agenda.events.filter((event) => subtreeIds.has(event.item_id.trim().toLowerCase()));
-    const agendaEvents = filterTerminalCalendarEvents(scopedAgenda, runtime.statusRegistry).slice(0, runtime.limit);
-    return { agenda, agendaEvents, agendaSummary: summarizeAgenda(agendaEvents) };
+    const fullAgendaEvents = filterTerminalCalendarEvents(scopedAgenda, runtime.statusRegistry).slice(0, runtime.limit);
+    const agendaEvents = fullAgendaEvents.map((event) => {
+        if (!listedFocusIds.has(event.item_id)) {
+            return event;
+        }
+        return {
+            at: event.at,
+            date: event.date,
+            kind: event.kind,
+            item_id: event.item_id,
+            reference_only: true,
+            ...(event.kind === "reminder"
+                ? { reminder_text: event.reminder_text }
+                : {}),
+            ...(event.kind === "event"
+                ? {
+                    event_title: event.event_title,
+                    event_recurring: event.event_recurring,
+                }
+                : {}),
+        };
+    });
+    return {
+        agenda,
+        agendaEvents,
+        agendaSummary: summarizeAgenda(fullAgendaEvents),
+    };
 }
 function countContextStatus(items, status, statusRegistry) {
     const targetStatus = String(status);
@@ -1408,7 +1442,11 @@ export async function runContext(options, global) {
     // the full corpus so terminal blocker targets count as satisfied at every depth.
     const blockedIds = collectDependencyBlockedIds(corpus.fullCorpus, runtime.statusRegistry);
     const focusGroups = await resolveContextFocusGroups(corpus.listedItemMetadata, corpus.allItems, blockedIds, runtime.statusRegistry, runtime.sectionsIncluded, runtime.limit, nowIso(), author, options.after, buildContextCursorFingerprint(options), shouldPageContextFocus(options, corpus.fullCorpus.length), pmRoot);
-    const agendaContext = await buildContextAgenda(options, global, runtime, corpus.subtreeIds);
+    const agendaContext = await buildContextAgenda(options, global, runtime, corpus.subtreeIds, new Set([
+        ...focusGroups.highLevel,
+        ...focusGroups.lowLevel,
+        ...focusGroups.blockedFallback,
+    ].map((item) => item.id)));
     const warnings = mergeSortedWarnings(corpus.listed.warnings, agendaContext.agenda.warnings, focusGroups.ranking.warnings);
     const inProgressCount = countContextStatus(focusGroups.activeItems, normalizeStatusInput("in_progress", runtime.statusRegistry), runtime.statusRegistry);
     const openCount = countContextStatus(focusGroups.activeItems, normalizeStatusInput("open", runtime.statusRegistry), runtime.statusRegistry);
@@ -1483,4 +1521,4 @@ export async function runContext(options, global) {
     return result;
 }
 //# sourceMappingURL=context.js.map
-//# debugId=2df694f8-45bb-5a5c-aea9-30da2ed1633d
+//# debugId=73237ae4-dd9f-5a67-9053-b2ffed05b1cf