@unbrained/pm-cli 2026.6.9 → 2026.6.11

package/dist/sdk/index.d.ts

@@ -48,6 +48,6 @@ export interface ExtensionModule {
  * `export default defineExtension({ activate(api) { ... } })`
  */
 export declare function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule;
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
 export type { GlobalOptions } from "../core/shared/command-types.js";
 export type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from "../types/index.js";

package/dist/sdk/index.js

@@ -1,5 +1,5 @@
 
-!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]="d13f5b40-8e83-5eab-998b-779d9130e847")}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]="6a579fbb-e3f9-568e-9736-1c4c9e4c446f")}catch(e){}}();
 import { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES, KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_TRUST_MODES, } from "../core/extensions/loader.js";
 export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, } from "../core/packages/manifest.js";
 export * from "./cli-contracts.js";
@@ -33,4 +33,4 @@ export function defineExtension(module) {
     return module;
 }
 //# sourceMappingURL=index.js.map
-//# debugId=d13f5b40-8e83-5eab-998b-779d9130e847
+//# debugId=6a579fbb-e3f9-568e-9736-1c4c9e4c446f

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["import {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n  type ExtensionApi,\n  type ExtensionManifest,\n} from \"../core/extensions/loader.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport * from \"./cli-contracts.js\";\nexport * from \"./runtime.js\";\nexport {\n  assertPackageManifest,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  type ActivateExtensionForTestOptions,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\nexport interface ExtensionModule {\n  /**\n   * Optional in-module metadata mirror.\n   *\n   * The authoritative manifest remains on-disk `manifest.json`; this field is\n   * useful when authors want colocated metadata for tooling/tests.\n   */\n  manifest?: ExtensionManifest;\n  activate(api: ExtensionApi): void | Promise<void>;\n  /**\n   * Optional teardown lifecycle hook (VS Code-style `deactivate`). Invoked by\n   * the host on shutdown/reload to release resources opened during `activate`.\n   */\n  deactivate?(): void | Promise<void>;\n}\n\n/**\n * Typed identity helper for extension module exports.\n *\n * Use as:\n * `export default defineExtension({ activate(api) { ... } })`\n */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":";;AAAA,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAG5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,GAOtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,kCAAkC,EAClC,wBAAwB,GAoBzB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAM3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAkBrH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"d13f5b40-8e83-5eab-998b-779d9130e847"}
+{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["import {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n  type ExtensionApi,\n  type ExtensionManifest,\n} from \"../core/extensions/loader.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport * from \"./cli-contracts.js\";\nexport * from \"./runtime.js\";\nexport {\n  assertPackageManifest,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  type ActivateExtensionForTestOptions,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\nexport interface ExtensionModule {\n  /**\n   * Optional in-module metadata mirror.\n   *\n   * The authoritative manifest remains on-disk `manifest.json`; this field is\n   * useful when authors want colocated metadata for tooling/tests.\n   */\n  manifest?: ExtensionManifest;\n  activate(api: ExtensionApi): void | Promise<void>;\n  /**\n   * Optional teardown lifecycle hook (VS Code-style `deactivate`). Invoked by\n   * the host on shutdown/reload to release resources opened during `activate`.\n   */\n  deactivate?(): void | Promise<void>;\n}\n\n/**\n * Typed identity helper for extension module exports.\n *\n * Use as:\n * `export default defineExtension({ activate(api) { ... } })`\n */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":";;AAAA,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAG5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,GAOtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,kCAAkC,EAClC,wBAAwB,GAoBzB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAM3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAkBrH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"6a579fbb-e3f9-568e-9736-1c4c9e4c446f"}

package/dist/sdk/runtime.d.ts

@@ -51,6 +51,12 @@ export interface WorkspaceContracts {
     closeStatus: string;
     canceledStatus: string;
 }
+/**
+ * Drop all memoized workspace extension registrations so the next
+ * `getWorkspaceContracts` call re-loads and re-activates extensions from disk.
+ * Long-lived hosts should call this after any extension or settings mutation.
+ */
+export declare function clearWorkspaceContractsCache(): void;
 export declare function getWorkspaceContracts(pmRoot: string, options?: WorkspaceContractsOptions): Promise<WorkspaceContracts>;
 export declare function getContracts(pmRootOrOptions?: string | GetContractsOptions, options?: GetContractsOptions): Promise<ContractsResult>;
 export type { ContractsCommandOptions, ContractsResult };

package/dist/sdk/runtime.js

@@ -1,5 +1,6 @@
 
-!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]="090338d5-3b0f-5033-8230-ee61e57f0b3e")}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]="8950122b-e360-52fa-950b-98234ff595b1")}catch(e){}}();
+import path from "node:path";
 import { activateExtensions, loadExtensions, } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
@@ -35,10 +36,57 @@ export { runSearch } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
+/**
+ * Process-lifetime memo of activated extension registrations, keyed by resolved
+ * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently
+ * called by importers and package runtimes that cannot thread a registry
+ * through; without the memo each call re-discovers, re-imports, and re-activates
+ * every extension.
+ *
+ * Invalidation story: entries are size-bounded and otherwise live until cleared.
+ * One-shot CLI processes are trivially correct. Long-lived hosts (e.g. the MCP
+ * server) must either pass `options.extensionRegistrations` (which bypasses the
+ * memo) or call {@link clearWorkspaceContractsCache} after installing/removing/
+ * toggling extensions or editing settings. Settings themselves are re-read on
+ * every call — only the extension load+activate step is memoized.
+ */
+const WORKSPACE_CONTRACTS_CACHE_LIMIT = 50;
+const workspaceExtensionRegistrationsCache = new Map();
+function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd) {
+    return JSON.stringify([
+        path.resolve(pmRoot),
+        path.resolve(cwd ?? process.cwd()),
+        settings.extensions.enabled,
+        settings.extensions.disabled,
+        settings.extensions.policy,
+    ]);
+}
+/**
+ * Drop all memoized workspace extension registrations so the next
+ * `getWorkspaceContracts` call re-loads and re-activates extensions from disk.
+ * Long-lived hosts should call this after any extension or settings mutation.
+ */
+export function clearWorkspaceContractsCache() {
+    workspaceExtensionRegistrationsCache.clear();
+}
+async function resolveWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
+    const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);
+    const cached = workspaceExtensionRegistrationsCache.get(cacheKey);
+    if (cached !== undefined) {
+        return cached;
+    }
+    if (workspaceExtensionRegistrationsCache.size >= WORKSPACE_CONTRACTS_CACHE_LIMIT) {
+        const oldestKey = workspaceExtensionRegistrationsCache.keys().next().value;
+        workspaceExtensionRegistrationsCache.delete(oldestKey);
+    }
+    const registrations = loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd);
+    workspaceExtensionRegistrationsCache.set(cacheKey, registrations);
+    return registrations;
+}
 export async function getWorkspaceContracts(pmRoot, options = {}) {
     const settings = await readSettings(pmRoot);
     const extensionRegistrations = options.extensionRegistrations ??
-        (options.noExtensions === true ? null : await loadWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
+        (options.noExtensions === true ? null : await resolveWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
     const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     return {
@@ -74,4 +122,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     return activationResult.registrations;
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=090338d5-3b0f-5033-8230-ee61e57f0b3e
+//# debugId=8950122b-e360-52fa-950b-98234ff595b1

package/dist/sdk/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["import {\n  activateExtensions,\n  loadExtensions,\n  type ExtensionRegistrationRegistry,\n} from \"../core/extensions/index.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"../cli/commands/contracts.js\";\n\nexport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nexport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../core/fs/fs-utils.js\";\nexport { appendHistoryEntry, createHistoryEntry } from \"../core/history/history.js\";\nexport { generateItemId, normalizeItemId, normalizeRawItemId } from \"../core/item/id.js\";\nexport { readBooleanOption, readCsvListOption, readStringOption } from \"./package-runtime-options.js\";\nexport {\n  PM_CLI_EXPECTED_ERROR_NAME,\n  createPmCliExpectedError,\n  isPmCliExpectedError,\n  type CreatePmCliExpectedErrorOptions,\n  type PmCliExpectedError,\n} from \"./errors.js\";\nexport {\n  commitImportedItem,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  selectImportAuthor,\n  toEstimatedMinutesValue,\n  toImportPriority,\n  toImportStatus,\n  toImportTags,\n  toNonEmptyImportString,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n} from \"./package-import-adapters.js\";\nexport {\n  canonicalDocument,\n  normalizeFrontMatter,\n  serializeItemDocument,\n  splitFrontMatter,\n} from \"../core/item/item-format.js\";\nexport { parseTags } from \"../core/item/parse.js\";\nexport { normalizeStatusInput } from \"../core/item/status.js\";\nexport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nexport { acquireLock } from \"../core/lock/lock.js\";\nexport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nexport { EXIT_CODE } from \"../core/shared/constants.js\";\nexport { PmCliError } from \"../core/shared/errors.js\";\nexport { isTimestampLiteral, nowIso } from \"../core/shared/time.js\";\nexport { listAllFrontMatter, locateItem, readLocatedItem } from \"../core/store/item-store.js\";\nexport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nexport { readSettings } from \"../core/store/settings.js\";\nexport {\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  resolveCalendarOutputFormat,\n  runCalendar,\n  type CalendarOptions,\n  type CalendarResult,\n} from \"../cli/commands/calendar.js\";\nexport {\n  renderGuideMarkdown,\n  resolveGuideOutputFormat,\n  runGuide,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n} from \"../cli/commands/guide.js\";\nexport { runCompletion, type CompletionResult, type CompletionShell } from \"../cli/commands/completion.js\";\nexport {\n  runCommentsAudit,\n  type CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\n} from \"../cli/commands/comments-audit.js\";\nexport {\n  runDedupeAudit,\n  type DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n} from \"../cli/commands/dedupe-audit.js\";\nexport { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from \"../cli/commands/normalize.js\";\nexport { runReindex, type ReindexOptions, type ReindexResult } from \"../cli/commands/reindex.js\";\nexport { runSearch, type SearchOptions, type SearchResult } from \"../cli/commands/search.js\";\nexport {\n  loadCreateTemplateOptions,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  type CreateTemplateOptions,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n} from \"../cli/commands/templates.js\";\nexport {\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n} from \"../cli/commands/test-runs.js\";\nexport {\n  CONFIDENCE_TEXT_VALUES,\n  DEPENDENCY_KIND_VALUES,\n  BUILTIN_ITEM_TYPE_VALUES,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  RISK_VALUES,\n  STATUS_VALUES,\n} from \"../types/index.js\";\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  Dependency,\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n  LogNote,\n  PmSettings,\n} from \"../types/index.js\";\n\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\nexport async function getWorkspaceContracts(\n  pmRoot: string,\n  options: WorkspaceContractsOptions = {},\n): Promise<WorkspaceContracts> {\n  const settings = await readSettings(pmRoot);\n  const extensionRegistrations =\n    options.extensionRegistrations ??\n    (options.noExtensions === true ? null : await loadWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));\n  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n\n  return {\n    types: [...typeRegistry.types],\n    statuses: statusRegistry.definitions.map((definition) => definition.id),\n    openStatus: statusRegistry.open_status,\n    closeStatus: statusRegistry.close_status,\n    canceledStatus: statusRegistry.canceled_status,\n  };\n}\n\nexport async function getContracts(\n  pmRootOrOptions?: string | GetContractsOptions,\n  options: GetContractsOptions = {},\n): Promise<ContractsResult> {\n  const resolvedOptions =\n    typeof pmRootOrOptions === \"string\"\n      ? { ...options, pmRoot: pmRootOrOptions }\n      : (pmRootOrOptions ?? options);\n  const global: GlobalOptions = {\n    json: true,\n    quiet: resolvedOptions.quiet ?? true,\n    noExtensions: resolvedOptions.noExtensions ?? false,\n    noPager: true,\n    profile: resolvedOptions.profile ?? false,\n    path: resolvedOptions.pmRoot,\n  };\n\n  return runContracts(resolvedOptions, global);\n}\n\nasync function loadWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const loadResult = await loadExtensions({\n    pmRoot,\n    settings,\n    cwd: cwd ?? process.cwd(),\n    noExtensions: false,\n  });\n  const activationResult = await activateExtensions(loadResult);\n  return activationResult.registrations;\n}\n\nexport type { ContractsCommandOptions, ContractsResult };\n"],"names":[],"mappings":"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","debugId":"090338d5-3b0f-5033-8230-ee61e57f0b3e"}
+{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["import path from \"node:path\";\nimport {\n  activateExtensions,\n  loadExtensions,\n  type ExtensionRegistrationRegistry,\n} from \"../core/extensions/index.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"../cli/commands/contracts.js\";\n\nexport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nexport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../core/fs/fs-utils.js\";\nexport { appendHistoryEntry, createHistoryEntry } from \"../core/history/history.js\";\nexport { generateItemId, normalizeItemId, normalizeRawItemId } from \"../core/item/id.js\";\nexport { readBooleanOption, readCsvListOption, readStringOption } from \"./package-runtime-options.js\";\nexport {\n  PM_CLI_EXPECTED_ERROR_NAME,\n  createPmCliExpectedError,\n  isPmCliExpectedError,\n  type CreatePmCliExpectedErrorOptions,\n  type PmCliExpectedError,\n} from \"./errors.js\";\nexport {\n  commitImportedItem,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  selectImportAuthor,\n  toEstimatedMinutesValue,\n  toImportPriority,\n  toImportStatus,\n  toImportTags,\n  toNonEmptyImportString,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n} from \"./package-import-adapters.js\";\nexport {\n  canonicalDocument,\n  normalizeFrontMatter,\n  serializeItemDocument,\n  splitFrontMatter,\n} from \"../core/item/item-format.js\";\nexport { parseTags } from \"../core/item/parse.js\";\nexport { normalizeStatusInput } from \"../core/item/status.js\";\nexport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nexport { acquireLock } from \"../core/lock/lock.js\";\nexport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nexport { EXIT_CODE } from \"../core/shared/constants.js\";\nexport { PmCliError } from \"../core/shared/errors.js\";\nexport { isTimestampLiteral, nowIso } from \"../core/shared/time.js\";\nexport { listAllFrontMatter, locateItem, readLocatedItem } from \"../core/store/item-store.js\";\nexport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nexport { readSettings } from \"../core/store/settings.js\";\nexport {\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  resolveCalendarOutputFormat,\n  runCalendar,\n  type CalendarOptions,\n  type CalendarResult,\n} from \"../cli/commands/calendar.js\";\nexport {\n  renderGuideMarkdown,\n  resolveGuideOutputFormat,\n  runGuide,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n} from \"../cli/commands/guide.js\";\nexport { runCompletion, type CompletionResult, type CompletionShell } from \"../cli/commands/completion.js\";\nexport {\n  runCommentsAudit,\n  type CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\n} from \"../cli/commands/comments-audit.js\";\nexport {\n  runDedupeAudit,\n  type DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n} from \"../cli/commands/dedupe-audit.js\";\nexport { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from \"../cli/commands/normalize.js\";\nexport { runReindex, type ReindexOptions, type ReindexResult } from \"../cli/commands/reindex.js\";\nexport { runSearch, type SearchOptions, type SearchResult } from \"../cli/commands/search.js\";\nexport {\n  loadCreateTemplateOptions,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  type CreateTemplateOptions,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n} from \"../cli/commands/templates.js\";\nexport {\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n} from \"../cli/commands/test-runs.js\";\nexport {\n  CONFIDENCE_TEXT_VALUES,\n  DEPENDENCY_KIND_VALUES,\n  BUILTIN_ITEM_TYPE_VALUES,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  RISK_VALUES,\n  STATUS_VALUES,\n} from \"../types/index.js\";\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  Dependency,\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n  LogNote,\n  PmSettings,\n} from \"../types/index.js\";\n\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\n/**\n * Process-lifetime memo of activated extension registrations, keyed by resolved\n * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently\n * called by importers and package runtimes that cannot thread a registry\n * through; without the memo each call re-discovers, re-imports, and re-activates\n * every extension.\n *\n * Invalidation story: entries are size-bounded and otherwise live until cleared.\n * One-shot CLI processes are trivially correct. Long-lived hosts (e.g. the MCP\n * server) must either pass `options.extensionRegistrations` (which bypasses the\n * memo) or call {@link clearWorkspaceContractsCache} after installing/removing/\n * toggling extensions or editing settings. Settings themselves are re-read on\n * every call — only the extension load+activate step is memoized.\n */\nconst WORKSPACE_CONTRACTS_CACHE_LIMIT = 50;\nconst workspaceExtensionRegistrationsCache = new Map<string, Promise<ExtensionRegistrationRegistry | null>>();\n\nfunction buildWorkspaceExtensionRegistrationsCacheKey(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): string {\n  return JSON.stringify([\n    path.resolve(pmRoot),\n    path.resolve(cwd ?? process.cwd()),\n    settings.extensions.enabled,\n    settings.extensions.disabled,\n    settings.extensions.policy,\n  ]);\n}\n\n/**\n * Drop all memoized workspace extension registrations so the next\n * `getWorkspaceContracts` call re-loads and re-activates extensions from disk.\n * Long-lived hosts should call this after any extension or settings mutation.\n */\nexport function clearWorkspaceContractsCache(): void {\n  workspaceExtensionRegistrationsCache.clear();\n}\n\nasync function resolveWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);\n  const cached = workspaceExtensionRegistrationsCache.get(cacheKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  if (workspaceExtensionRegistrationsCache.size >= WORKSPACE_CONTRACTS_CACHE_LIMIT) {\n    const oldestKey = workspaceExtensionRegistrationsCache.keys().next().value!;\n    workspaceExtensionRegistrationsCache.delete(oldestKey);\n  }\n  const registrations = loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd);\n  workspaceExtensionRegistrationsCache.set(cacheKey, registrations);\n  return registrations;\n}\n\nexport async function getWorkspaceContracts(\n  pmRoot: string,\n  options: WorkspaceContractsOptions = {},\n): Promise<WorkspaceContracts> {\n  const settings = await readSettings(pmRoot);\n  const extensionRegistrations =\n    options.extensionRegistrations ??\n    (options.noExtensions === true ? null : await resolveWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));\n  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n\n  return {\n    types: [...typeRegistry.types],\n    statuses: statusRegistry.definitions.map((definition) => definition.id),\n    openStatus: statusRegistry.open_status,\n    closeStatus: statusRegistry.close_status,\n    canceledStatus: statusRegistry.canceled_status,\n  };\n}\n\nexport async function getContracts(\n  pmRootOrOptions?: string | GetContractsOptions,\n  options: GetContractsOptions = {},\n): Promise<ContractsResult> {\n  const resolvedOptions =\n    typeof pmRootOrOptions === \"string\"\n      ? { ...options, pmRoot: pmRootOrOptions }\n      : (pmRootOrOptions ?? options);\n  const global: GlobalOptions = {\n    json: true,\n    quiet: resolvedOptions.quiet ?? true,\n    noExtensions: resolvedOptions.noExtensions ?? false,\n    noPager: true,\n    profile: resolvedOptions.profile ?? false,\n    path: resolvedOptions.pmRoot,\n  };\n\n  return runContracts(resolvedOptions, global);\n}\n\nasync function loadWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const loadResult = await loadExtensions({\n    pmRoot,\n    settings,\n    cwd: cwd ?? process.cwd(),\n    noExtensions: false,\n  });\n  const activationResult = await activateExtensions(loadResult);\n  return activationResult.registrations;\n}\n\nexport type { ContractsCommandOptions, ContractsResult };\n"],"names":[],"mappings":"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","debugId":"8950122b-e360-52fa-950b-98234ff595b1"}

package/dist/types.d.ts

@@ -351,6 +351,7 @@ export interface ItemMetadata {
     test_runs?: ItemTestRunSummary[];
     docs?: LinkedDoc[];
     close_reason?: string;
+    duplicate_of?: string;
     plan_mode?: PlanMode;
     plan_scope?: string;
     plan_harness?: PlanHarness;
@@ -386,12 +387,14 @@ export interface HistoryEntry {
 }
 export declare const CONTEXT_DEPTH_VALUES: readonly ["brief", "standard", "deep"];
 export type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];
-export declare const CONTEXT_SECTION_VALUES: readonly ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"];
+export declare const CONTEXT_SECTION_VALUES: readonly ["hierarchy", "activity", "progress", "recently_created", "unparented", "blockers", "files", "workload", "staleness", "tests"];
 export type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];
 export interface ContextSectionSettings {
     hierarchy: boolean;
     activity: boolean;
     progress: boolean;
+    recently_created: boolean;
+    unparented: boolean;
     blockers: boolean;
     files: boolean;
     workload: boolean;

package/dist/types.js

@@ -1,5 +1,5 @@
 
-!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]="f62a6f2b-d501-5db4-97cd-8a97131d0db4")}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]="a6694379-22e4-5b33-9691-cca9ad16865c")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -119,6 +119,8 @@ export const CONTEXT_SECTION_VALUES = [
     "hierarchy",
     "activity",
     "progress",
+    "recently_created",
+    "unparented",
     "blockers",
     "files",
     "workload",
@@ -126,4 +128,4 @@ export const CONTEXT_SECTION_VALUES = [
     "tests",
 ];
 //# sourceMappingURL=types.js.map
-//# debugId=f62a6f2b-d501-5db4-97cd-8a97131d0db4
+//# debugId=a6694379-22e4-5b33-9691-cca9ad16865c

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["export const BUILTIN_ITEM_TYPE_VALUES = [\n  \"Epic\",\n  \"Feature\",\n  \"Task\",\n  \"Chore\",\n  \"Issue\",\n  \"Decision\",\n  \"Event\",\n  \"Reminder\",\n  \"Milestone\",\n  \"Meeting\",\n  \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n  \"draft\",\n  \"open\",\n  \"in_progress\",\n  \"blocked\",\n  \"closed\",\n  \"canceled\",\n] as const;\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n  \"draft\",\n  \"active\",\n  \"blocked\",\n  \"terminal\",\n  \"terminal_done\",\n  \"terminal_canceled\",\n  \"default_open\",\n  \"default_close\",\n  \"default_cancel\",\n] as const;\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n  \"blocks\",\n  \"parent\",\n  \"child\",\n  \"parent_child\",\n  \"child_of\",\n  \"related\",\n  \"related_to\",\n  \"discovered_from\",\n  \"blocked_by\",\n  \"incident_from\",\n  \"epic\",\n  \"supersedes\",\n  \"task\",\n] as const;\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\nexport type ConfidenceValue = number | ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n  \"author\",\n  \"acceptance_criteria\",\n  \"estimated_minutes\",\n  \"close_reason\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n] as const;\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/**\n * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n */\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n  return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\nexport interface Dependency {\n  id: string;\n  kind: DependencyKind;\n  created_at: string;\n  author?: string;\n  source_kind?: string;\n}\n\nexport interface Comment {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nexport interface LogNote {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nexport interface LinkedFile {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\nexport interface LinkedTest {\n  command?: string;\n  path?: string;\n  scope: LinkScope;\n  timeout_seconds?: number;\n  pm_context_mode?: \"schema\" | \"tracker\" | \"auto\";\n  env_set?: Record<string, string>;\n  env_clear?: string[];\n  shared_host_safe?: boolean;\n  assert_stdout_contains?: string[];\n  assert_stdout_regex?: string[];\n  assert_stderr_contains?: string[];\n  assert_stderr_regex?: string[];\n  assert_stdout_min_lines?: number;\n  assert_json_field_equals?: Record<string, string>;\n  assert_json_field_gte?: Record<string, number>;\n  note?: string;\n}\n\nexport interface LinkedDoc {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\nexport interface Reminder {\n  at: string;\n  text: string;\n}\n\nexport interface RecurrenceRule {\n  freq: RecurrenceFrequency;\n  interval?: number;\n  count?: number;\n  until?: string;\n  by_weekday?: RecurrenceWeekday[];\n  by_month_day?: number[];\n  exdates?: string[];\n}\n\nexport interface CalendarEvent {\n  start_at: string;\n  end_at?: string;\n  title?: string;\n  description?: string;\n  location?: string;\n  all_day?: boolean;\n  timezone?: string;\n  recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n  \"draft\",\n  \"research\",\n  \"review\",\n  \"approved\",\n  \"executing\",\n  \"paused\",\n  \"completed\",\n  \"superseded\",\n] as const;\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n  \"pending\",\n  \"in_progress\",\n  \"completed\",\n  \"blocked\",\n  \"skipped\",\n  \"superseded\",\n] as const;\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n  \"related\",\n  \"blocks\",\n  \"blocked_by\",\n  \"depends_on\",\n  \"discovered_from\",\n  \"implements\",\n  \"verifies\",\n  \"supersedes\",\n] as const;\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\nexport interface PlanStepLink {\n  id: string;\n  kind: PlanStepLinkKind;\n  note?: string;\n  required_before_step?: boolean;\n}\n\nexport interface PlanStepFile {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\nexport interface PlanStepTest {\n  command?: string;\n  path?: string;\n  note?: string;\n}\n\nexport interface PlanStepDoc {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\nexport interface PlanStep {\n  id: string;\n  order: number;\n  title: string;\n  body?: string;\n  status: PlanStepStatus;\n  owner?: string;\n  evidence?: string;\n  blocked_reason?: string;\n  superseded_by?: string;\n  linked_items?: PlanStepLink[];\n  files?: PlanStepFile[];\n  tests?: PlanStepTest[];\n  docs?: PlanStepDoc[];\n  created_at: string;\n  updated_at: string;\n  completed_at?: string;\n}\n\nexport interface PlanDecision {\n  ts: string;\n  author: string;\n  decision: string;\n  rationale?: string;\n  evidence?: string;\n  step_id?: string;\n}\n\nexport interface PlanDiscovery {\n  ts: string;\n  author: string;\n  text: string;\n  step_id?: string;\n}\n\nexport interface PlanValidationCheck {\n  text: string;\n  command?: string;\n  expected?: string;\n}\n\nexport interface ItemTypeOptionDefinition {\n  key: string;\n  values: string[];\n  required?: boolean;\n  aliases?: string[];\n  description?: string;\n}\n\nexport interface ItemTypeCommandOptionPolicy {\n  command: \"create\" | \"update\";\n  option: string;\n  required?: boolean;\n  visible?: boolean;\n  enabled?: boolean;\n}\n\nexport interface ItemTypeDefinition {\n  name: string;\n  description?: string;\n  /**\n   * Status assigned to newly created items of this type when `--status` is not\n   * provided. Falls back to the workflow's open status when unset or invalid.\n   */\n  default_status?: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  options?: ItemTypeOptionDefinition[];\n  command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\nexport interface RuntimeStatusDefinition {\n  id: string;\n  aliases?: string[];\n  roles?: RuntimeStatusRole[];\n  description?: string;\n  order?: number;\n}\n\nexport interface RuntimeFieldDefinition {\n  key: string;\n  metadata_key?: string;\n  /**\n   * @deprecated Use metadata_key.\n   */\n  front_matter_key?: string;\n  cli_flag?: string;\n  cli_aliases?: string[];\n  description?: string;\n  type?: RuntimeFieldType;\n  commands?: RuntimeFieldCommand[];\n  repeatable?: boolean;\n  required?: boolean;\n  required_on_create?: boolean;\n  required_types?: string[];\n  allow_unset?: boolean;\n}\n\nexport interface RuntimeWorkflowDefinition {\n  draft_status?: string;\n  open_status?: string;\n  in_progress_status?: string;\n  blocked_status?: string;\n  close_status?: string;\n  canceled_status?: string;\n}\n\nexport interface RuntimeSchemaFileConfig {\n  types?: string;\n  statuses?: string;\n  fields?: string;\n  workflows?: string;\n}\n\n/**\n * Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n */\nexport interface TypeWorkflowDefinition {\n  type: string;\n  allowed_transitions: [string, string][];\n}\n\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\n  type_workflows?: TypeWorkflowDefinition[];\n  unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\nexport interface ItemTestRunSummary {\n  run_id: string;\n  kind: \"test\" | \"test-all\";\n  status: \"passed\" | \"failed\" | \"stopped\" | \"canceled\";\n  started_at: string;\n  finished_at: string;\n  recorded_at: string;\n  attempt?: number;\n  resumed_from?: string;\n  passed: number;\n  failed: number;\n  skipped: number;\n  items?: number;\n  linked_tests?: number;\n  fail_on_skipped_triggered?: boolean;\n}\n\nexport interface ItemMetadata {\n  id: string;\n  title: string;\n  description: string;\n  type: ItemType;\n  source_type?: string;\n  type_options?: Record<string, string>;\n  status: ItemStatus;\n  priority: 0 | 1 | 2 | 3 | 4;\n  tags: string[];\n  created_at: string;\n  updated_at: string;\n  deadline?: string;\n  reminders?: Reminder[];\n  events?: CalendarEvent[];\n  closed_at?: string;\n  assignee?: string;\n  source_owner?: string;\n  author?: string;\n  estimated_minutes?: number;\n  acceptance_criteria?: string;\n  design?: string;\n  external_ref?: string;\n  definition_of_ready?: string;\n  order?: number;\n  goal?: string;\n  objective?: string;\n  value?: string;\n  impact?: string;\n  outcome?: string;\n  why_now?: string;\n  parent?: string;\n  reviewer?: string;\n  risk?: RiskLevel;\n  confidence?: ConfidenceValue;\n  sprint?: string;\n  release?: string;\n  blocked_by?: string;\n  blocked_reason?: string;\n  unblock_note?: string;\n  reporter?: string;\n  severity?: IssueSeverity;\n  environment?: string;\n  repro_steps?: string;\n  resolution?: string;\n  expected_result?: string;\n  actual_result?: string;\n  affected_version?: string;\n  fixed_version?: string;\n  component?: string;\n  regression?: boolean;\n  customer_impact?: string;\n  dependencies?: Dependency[];\n  comments?: Comment[];\n  notes?: LogNote[];\n  learnings?: LogNote[];\n  files?: LinkedFile[];\n  tests?: LinkedTest[];\n  test_runs?: ItemTestRunSummary[];\n  docs?: LinkedDoc[];\n  close_reason?: string;\n  plan_mode?: PlanMode;\n  plan_scope?: string;\n  plan_harness?: PlanHarness;\n  plan_steps?: PlanStep[];\n  plan_decisions?: PlanDecision[];\n  plan_discoveries?: PlanDiscovery[];\n  plan_validation?: PlanValidationCheck[];\n  plan_resume_context?: string;\n  [key: string]: unknown;\n}\n\n/**\n * @deprecated Use ItemMetadata.\n */\nexport type ItemFrontMatter = ItemMetadata;\n\nexport interface ItemDocument {\n  metadata: ItemMetadata;\n  body: string;\n}\n\nexport interface HistoryPatchOp {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  from?: string;\n  value?: unknown;\n}\n\nexport interface HistoryEntry {\n  ts: string;\n  author: string;\n  op: string;\n  patch: HistoryPatchOp[];\n  before_hash: string;\n  after_hash: string;\n  message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n  \"hierarchy\",\n  \"activity\",\n  \"progress\",\n  \"blockers\",\n  \"files\",\n  \"workload\",\n  \"staleness\",\n  \"tests\",\n] as const;\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\nexport interface ContextSectionSettings {\n  hierarchy: boolean;\n  activity: boolean;\n  progress: boolean;\n  blockers: boolean;\n  files: boolean;\n  workload: boolean;\n  staleness: boolean;\n  tests: boolean;\n}\n\nexport interface ContextSettings {\n  default_depth: ContextDepth;\n  activity_limit: number;\n  stale_threshold_days: number;\n  sections: ContextSectionSettings;\n}\n\nexport interface GovernanceSettings {\n  preset: GovernancePreset;\n  ownership_enforcement: GovernanceOwnershipEnforcement;\n  create_mode_default: GovernanceCreateModeDefault;\n  close_validation_default: GovernanceCloseValidationDefault;\n  require_close_reason: boolean;\n  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\n  create_default_type?: string;\n  /**\n   * Per-type allowed-transition enforcement mode for `pm update --status`.\n   * Read raw from settings (not preset-derived) so existing projects are\n   * unaffected when unset; defaults to \"off\".\n   */\n  workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\nexport type ExtensionPolicyMode = \"off\" | \"warn\" | \"enforce\";\nexport type ExtensionTrustMode = \"off\" | \"warn\" | \"enforce\";\nexport type ExtensionSandboxProfile = \"none\" | \"restricted\" | \"strict\";\n\nexport interface ExtensionPolicyOverrideSettings {\n  name: string;\n  disabled?: boolean;\n  require_trusted?: boolean;\n  require_provenance?: boolean;\n  sandbox_profile?: ExtensionSandboxProfile;\n  allowed_capabilities?: string[];\n  blocked_capabilities?: string[];\n  allowed_surfaces?: string[];\n  blocked_surfaces?: string[];\n  allowed_commands?: string[];\n  blocked_commands?: string[];\n  allowed_actions?: string[];\n  blocked_actions?: string[];\n  allowed_services?: string[];\n  blocked_services?: string[];\n}\n\nexport interface ExtensionPolicySettings {\n  mode: ExtensionPolicyMode;\n  trust_mode: ExtensionTrustMode;\n  require_provenance: boolean;\n  trusted_extensions: string[];\n  default_sandbox_profile: ExtensionSandboxProfile;\n  allowed_extensions: string[];\n  blocked_extensions: string[];\n  allowed_capabilities: string[];\n  blocked_capabilities: string[];\n  allowed_surfaces: string[];\n  blocked_surfaces: string[];\n  allowed_commands: string[];\n  blocked_commands: string[];\n  allowed_actions: string[];\n  blocked_actions: string[];\n  allowed_services: string[];\n  blocked_services: string[];\n  extension_overrides: ExtensionPolicyOverrideSettings[];\n}\n\nexport interface AgentGuidanceSettings {\n  prompt_completed: boolean;\n  declined: boolean;\n  declined_at: string;\n  template_version: number;\n  last_checked_files: string[];\n}\n\nexport type SearchMutationRefreshPolicy = \"cache_only\" | \"semantic_configured\" | \"semantic_auto\";\n\nexport interface SearchQueryExpansionSettings {\n  enabled: boolean;\n  provider: string;\n}\n\nexport interface SearchRerankSettings {\n  enabled: boolean;\n  model: string;\n  top_k: number;\n}\n\nexport interface PmSettings {\n  version: number;\n  id_prefix: string;\n  author_default: string;\n  item_format: ItemFormat;\n  locks: {\n    ttl_seconds: number;\n  };\n  output: {\n    default_format: \"toon\" | \"json\";\n  };\n  history: {\n    missing_stream: \"auto_create\" | \"strict_error\";\n  };\n  validation: {\n    sprint_release_format: SprintReleaseFormatPolicy;\n    parent_reference: ParentReferencePolicy;\n    metadata_profile: ValidateMetadataProfile;\n    metadata_required_fields: ValidateMetadataRequiredField[];\n    lifecycle_stale_blocker_reason_patterns: string[];\n    lifecycle_closure_like_blocked_reason_patterns: string[];\n    lifecycle_closure_like_resolution_patterns: string[];\n    lifecycle_closure_like_actual_result_patterns: string[];\n  };\n  governance: GovernanceSettings;\n  workflow: {\n    definition_of_done: string[];\n  };\n  testing: {\n    record_results_to_items: boolean;\n  };\n  telemetry: {\n    enabled: boolean;\n    first_run_prompt_completed: boolean;\n    capture_level: \"minimal\" | \"redacted\" | \"max\";\n    endpoint: string;\n    installation_id: string;\n    retention_days: number;\n  };\n  agent_guidance: AgentGuidanceSettings;\n  item_types: {\n    definitions: ItemTypeDefinition[];\n  };\n  schema: RuntimeSchemaSettings;\n  extensions: {\n    enabled: string[];\n    disabled: string[];\n    policy: ExtensionPolicySettings;\n  };\n  search: {\n    score_threshold: number;\n    hybrid_semantic_weight: number;\n    max_results: number;\n    embedding_model: string;\n    embedding_corpus_max_characters?: number;\n    embedding_batch_size: number;\n    embedding_timeout_ms: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\n    mutation_refresh_policy: SearchMutationRefreshPolicy;\n    query_expansion: SearchQueryExpansionSettings;\n    rerank: SearchRerankSettings;\n    tuning?: {\n      title_exact_bonus?: number;\n      title_weight?: number;\n      description_weight?: number;\n      tags_weight?: number;\n      status_weight?: number;\n      body_weight?: number;\n      comments_weight?: number;\n      notes_weight?: number;\n      learnings_weight?: number;\n      dependencies_weight?: number;\n      linked_content_weight?: number;\n    };\n  };\n  providers: {\n    openai: {\n      base_url: string;\n      api_key: string;\n      model: string;\n    };\n    ollama: {\n      base_url: string;\n      model: string;\n    };\n  };\n  context: ContextSettings;\n  vector_store: {\n    adapter?: string;\n    collection_name: string;\n    qdrant: {\n      url: string;\n      api_key: string;\n    };\n    lancedb: {\n      path: string;\n    };\n  };\n}\n"],"names":[],"mappings":"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","debugId":"f62a6f2b-d501-5db4-97cd-8a97131d0db4"}
+{"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["export const BUILTIN_ITEM_TYPE_VALUES = [\n  \"Epic\",\n  \"Feature\",\n  \"Task\",\n  \"Chore\",\n  \"Issue\",\n  \"Decision\",\n  \"Event\",\n  \"Reminder\",\n  \"Milestone\",\n  \"Meeting\",\n  \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n  \"draft\",\n  \"open\",\n  \"in_progress\",\n  \"blocked\",\n  \"closed\",\n  \"canceled\",\n] as const;\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n  \"draft\",\n  \"active\",\n  \"blocked\",\n  \"terminal\",\n  \"terminal_done\",\n  \"terminal_canceled\",\n  \"default_open\",\n  \"default_close\",\n  \"default_cancel\",\n] as const;\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n  \"blocks\",\n  \"parent\",\n  \"child\",\n  \"parent_child\",\n  \"child_of\",\n  \"related\",\n  \"related_to\",\n  \"discovered_from\",\n  \"blocked_by\",\n  \"incident_from\",\n  \"epic\",\n  \"supersedes\",\n  \"task\",\n] as const;\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\nexport type ConfidenceValue = number | ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n  \"author\",\n  \"acceptance_criteria\",\n  \"estimated_minutes\",\n  \"close_reason\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n] as const;\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/**\n * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n */\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n  return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\nexport interface Dependency {\n  id: string;\n  kind: DependencyKind;\n  created_at: string;\n  author?: string;\n  source_kind?: string;\n}\n\nexport interface Comment {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nexport interface LogNote {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nexport interface LinkedFile {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\nexport interface LinkedTest {\n  command?: string;\n  path?: string;\n  scope: LinkScope;\n  timeout_seconds?: number;\n  pm_context_mode?: \"schema\" | \"tracker\" | \"auto\";\n  env_set?: Record<string, string>;\n  env_clear?: string[];\n  shared_host_safe?: boolean;\n  assert_stdout_contains?: string[];\n  assert_stdout_regex?: string[];\n  assert_stderr_contains?: string[];\n  assert_stderr_regex?: string[];\n  assert_stdout_min_lines?: number;\n  assert_json_field_equals?: Record<string, string>;\n  assert_json_field_gte?: Record<string, number>;\n  note?: string;\n}\n\nexport interface LinkedDoc {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\nexport interface Reminder {\n  at: string;\n  text: string;\n}\n\nexport interface RecurrenceRule {\n  freq: RecurrenceFrequency;\n  interval?: number;\n  count?: number;\n  until?: string;\n  by_weekday?: RecurrenceWeekday[];\n  by_month_day?: number[];\n  exdates?: string[];\n}\n\nexport interface CalendarEvent {\n  start_at: string;\n  end_at?: string;\n  title?: string;\n  description?: string;\n  location?: string;\n  all_day?: boolean;\n  timezone?: string;\n  recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n  \"draft\",\n  \"research\",\n  \"review\",\n  \"approved\",\n  \"executing\",\n  \"paused\",\n  \"completed\",\n  \"superseded\",\n] as const;\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n  \"pending\",\n  \"in_progress\",\n  \"completed\",\n  \"blocked\",\n  \"skipped\",\n  \"superseded\",\n] as const;\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n  \"related\",\n  \"blocks\",\n  \"blocked_by\",\n  \"depends_on\",\n  \"discovered_from\",\n  \"implements\",\n  \"verifies\",\n  \"supersedes\",\n] as const;\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\nexport interface PlanStepLink {\n  id: string;\n  kind: PlanStepLinkKind;\n  note?: string;\n  required_before_step?: boolean;\n}\n\nexport interface PlanStepFile {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\nexport interface PlanStepTest {\n  command?: string;\n  path?: string;\n  note?: string;\n}\n\nexport interface PlanStepDoc {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\nexport interface PlanStep {\n  id: string;\n  order: number;\n  title: string;\n  body?: string;\n  status: PlanStepStatus;\n  owner?: string;\n  evidence?: string;\n  blocked_reason?: string;\n  superseded_by?: string;\n  linked_items?: PlanStepLink[];\n  files?: PlanStepFile[];\n  tests?: PlanStepTest[];\n  docs?: PlanStepDoc[];\n  created_at: string;\n  updated_at: string;\n  completed_at?: string;\n}\n\nexport interface PlanDecision {\n  ts: string;\n  author: string;\n  decision: string;\n  rationale?: string;\n  evidence?: string;\n  step_id?: string;\n}\n\nexport interface PlanDiscovery {\n  ts: string;\n  author: string;\n  text: string;\n  step_id?: string;\n}\n\nexport interface PlanValidationCheck {\n  text: string;\n  command?: string;\n  expected?: string;\n}\n\nexport interface ItemTypeOptionDefinition {\n  key: string;\n  values: string[];\n  required?: boolean;\n  aliases?: string[];\n  description?: string;\n}\n\nexport interface ItemTypeCommandOptionPolicy {\n  command: \"create\" | \"update\";\n  option: string;\n  required?: boolean;\n  visible?: boolean;\n  enabled?: boolean;\n}\n\nexport interface ItemTypeDefinition {\n  name: string;\n  description?: string;\n  /**\n   * Status assigned to newly created items of this type when `--status` is not\n   * provided. Falls back to the workflow's open status when unset or invalid.\n   */\n  default_status?: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  options?: ItemTypeOptionDefinition[];\n  command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\nexport interface RuntimeStatusDefinition {\n  id: string;\n  aliases?: string[];\n  roles?: RuntimeStatusRole[];\n  description?: string;\n  order?: number;\n}\n\nexport interface RuntimeFieldDefinition {\n  key: string;\n  metadata_key?: string;\n  /**\n   * @deprecated Use metadata_key.\n   */\n  front_matter_key?: string;\n  cli_flag?: string;\n  cli_aliases?: string[];\n  description?: string;\n  type?: RuntimeFieldType;\n  commands?: RuntimeFieldCommand[];\n  repeatable?: boolean;\n  required?: boolean;\n  required_on_create?: boolean;\n  required_types?: string[];\n  allow_unset?: boolean;\n}\n\nexport interface RuntimeWorkflowDefinition {\n  draft_status?: string;\n  open_status?: string;\n  in_progress_status?: string;\n  blocked_status?: string;\n  close_status?: string;\n  canceled_status?: string;\n}\n\nexport interface RuntimeSchemaFileConfig {\n  types?: string;\n  statuses?: string;\n  fields?: string;\n  workflows?: string;\n}\n\n/**\n * Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n */\nexport interface TypeWorkflowDefinition {\n  type: string;\n  allowed_transitions: [string, string][];\n}\n\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\n  type_workflows?: TypeWorkflowDefinition[];\n  unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\nexport interface ItemTestRunSummary {\n  run_id: string;\n  kind: \"test\" | \"test-all\";\n  status: \"passed\" | \"failed\" | \"stopped\" | \"canceled\";\n  started_at: string;\n  finished_at: string;\n  recorded_at: string;\n  attempt?: number;\n  resumed_from?: string;\n  passed: number;\n  failed: number;\n  skipped: number;\n  items?: number;\n  linked_tests?: number;\n  fail_on_skipped_triggered?: boolean;\n}\n\nexport interface ItemMetadata {\n  id: string;\n  title: string;\n  description: string;\n  type: ItemType;\n  source_type?: string;\n  type_options?: Record<string, string>;\n  status: ItemStatus;\n  priority: 0 | 1 | 2 | 3 | 4;\n  tags: string[];\n  created_at: string;\n  updated_at: string;\n  deadline?: string;\n  reminders?: Reminder[];\n  events?: CalendarEvent[];\n  closed_at?: string;\n  assignee?: string;\n  source_owner?: string;\n  author?: string;\n  estimated_minutes?: number;\n  acceptance_criteria?: string;\n  design?: string;\n  external_ref?: string;\n  definition_of_ready?: string;\n  order?: number;\n  goal?: string;\n  objective?: string;\n  value?: string;\n  impact?: string;\n  outcome?: string;\n  why_now?: string;\n  parent?: string;\n  reviewer?: string;\n  risk?: RiskLevel;\n  confidence?: ConfidenceValue;\n  sprint?: string;\n  release?: string;\n  blocked_by?: string;\n  blocked_reason?: string;\n  unblock_note?: string;\n  reporter?: string;\n  severity?: IssueSeverity;\n  environment?: string;\n  repro_steps?: string;\n  resolution?: string;\n  expected_result?: string;\n  actual_result?: string;\n  affected_version?: string;\n  fixed_version?: string;\n  component?: string;\n  regression?: boolean;\n  customer_impact?: string;\n  dependencies?: Dependency[];\n  comments?: Comment[];\n  notes?: LogNote[];\n  learnings?: LogNote[];\n  files?: LinkedFile[];\n  tests?: LinkedTest[];\n  test_runs?: ItemTestRunSummary[];\n  docs?: LinkedDoc[];\n  close_reason?: string;\n  duplicate_of?: string;\n  plan_mode?: PlanMode;\n  plan_scope?: string;\n  plan_harness?: PlanHarness;\n  plan_steps?: PlanStep[];\n  plan_decisions?: PlanDecision[];\n  plan_discoveries?: PlanDiscovery[];\n  plan_validation?: PlanValidationCheck[];\n  plan_resume_context?: string;\n  [key: string]: unknown;\n}\n\n/**\n * @deprecated Use ItemMetadata.\n */\nexport type ItemFrontMatter = ItemMetadata;\n\nexport interface ItemDocument {\n  metadata: ItemMetadata;\n  body: string;\n}\n\nexport interface HistoryPatchOp {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  from?: string;\n  value?: unknown;\n}\n\nexport interface HistoryEntry {\n  ts: string;\n  author: string;\n  op: string;\n  patch: HistoryPatchOp[];\n  before_hash: string;\n  after_hash: string;\n  message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\"] as const;\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n  \"hierarchy\",\n  \"activity\",\n  \"progress\",\n  \"recently_created\",\n  \"unparented\",\n  \"blockers\",\n  \"files\",\n  \"workload\",\n  \"staleness\",\n  \"tests\",\n] as const;\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\nexport interface ContextSectionSettings {\n  hierarchy: boolean;\n  activity: boolean;\n  progress: boolean;\n  recently_created: boolean;\n  unparented: boolean;\n  blockers: boolean;\n  files: boolean;\n  workload: boolean;\n  staleness: boolean;\n  tests: boolean;\n}\n\nexport interface ContextSettings {\n  default_depth: ContextDepth;\n  activity_limit: number;\n  stale_threshold_days: number;\n  sections: ContextSectionSettings;\n}\n\nexport interface GovernanceSettings {\n  preset: GovernancePreset;\n  ownership_enforcement: GovernanceOwnershipEnforcement;\n  create_mode_default: GovernanceCreateModeDefault;\n  close_validation_default: GovernanceCloseValidationDefault;\n  require_close_reason: boolean;\n  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\n  create_default_type?: string;\n  /**\n   * Per-type allowed-transition enforcement mode for `pm update --status`.\n   * Read raw from settings (not preset-derived) so existing projects are\n   * unaffected when unset; defaults to \"off\".\n   */\n  workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\nexport type ExtensionPolicyMode = \"off\" | \"warn\" | \"enforce\";\nexport type ExtensionTrustMode = \"off\" | \"warn\" | \"enforce\";\nexport type ExtensionSandboxProfile = \"none\" | \"restricted\" | \"strict\";\n\nexport interface ExtensionPolicyOverrideSettings {\n  name: string;\n  disabled?: boolean;\n  require_trusted?: boolean;\n  require_provenance?: boolean;\n  sandbox_profile?: ExtensionSandboxProfile;\n  allowed_capabilities?: string[];\n  blocked_capabilities?: string[];\n  allowed_surfaces?: string[];\n  blocked_surfaces?: string[];\n  allowed_commands?: string[];\n  blocked_commands?: string[];\n  allowed_actions?: string[];\n  blocked_actions?: string[];\n  allowed_services?: string[];\n  blocked_services?: string[];\n}\n\nexport interface ExtensionPolicySettings {\n  mode: ExtensionPolicyMode;\n  trust_mode: ExtensionTrustMode;\n  require_provenance: boolean;\n  trusted_extensions: string[];\n  default_sandbox_profile: ExtensionSandboxProfile;\n  allowed_extensions: string[];\n  blocked_extensions: string[];\n  allowed_capabilities: string[];\n  blocked_capabilities: string[];\n  allowed_surfaces: string[];\n  blocked_surfaces: string[];\n  allowed_commands: string[];\n  blocked_commands: string[];\n  allowed_actions: string[];\n  blocked_actions: string[];\n  allowed_services: string[];\n  blocked_services: string[];\n  extension_overrides: ExtensionPolicyOverrideSettings[];\n}\n\nexport interface AgentGuidanceSettings {\n  prompt_completed: boolean;\n  declined: boolean;\n  declined_at: string;\n  template_version: number;\n  last_checked_files: string[];\n}\n\nexport type SearchMutationRefreshPolicy = \"cache_only\" | \"semantic_configured\" | \"semantic_auto\";\n\nexport interface SearchQueryExpansionSettings {\n  enabled: boolean;\n  provider: string;\n}\n\nexport interface SearchRerankSettings {\n  enabled: boolean;\n  model: string;\n  top_k: number;\n}\n\nexport interface PmSettings {\n  version: number;\n  id_prefix: string;\n  author_default: string;\n  item_format: ItemFormat;\n  locks: {\n    ttl_seconds: number;\n  };\n  output: {\n    default_format: \"toon\" | \"json\";\n  };\n  history: {\n    missing_stream: \"auto_create\" | \"strict_error\";\n  };\n  validation: {\n    sprint_release_format: SprintReleaseFormatPolicy;\n    parent_reference: ParentReferencePolicy;\n    metadata_profile: ValidateMetadataProfile;\n    metadata_required_fields: ValidateMetadataRequiredField[];\n    lifecycle_stale_blocker_reason_patterns: string[];\n    lifecycle_closure_like_blocked_reason_patterns: string[];\n    lifecycle_closure_like_resolution_patterns: string[];\n    lifecycle_closure_like_actual_result_patterns: string[];\n  };\n  governance: GovernanceSettings;\n  workflow: {\n    definition_of_done: string[];\n  };\n  testing: {\n    record_results_to_items: boolean;\n  };\n  telemetry: {\n    enabled: boolean;\n    first_run_prompt_completed: boolean;\n    capture_level: \"minimal\" | \"redacted\" | \"max\";\n    endpoint: string;\n    installation_id: string;\n    retention_days: number;\n  };\n  agent_guidance: AgentGuidanceSettings;\n  item_types: {\n    definitions: ItemTypeDefinition[];\n  };\n  schema: RuntimeSchemaSettings;\n  extensions: {\n    enabled: string[];\n    disabled: string[];\n    policy: ExtensionPolicySettings;\n  };\n  search: {\n    score_threshold: number;\n    hybrid_semantic_weight: number;\n    max_results: number;\n    embedding_model: string;\n    embedding_corpus_max_characters?: number;\n    embedding_batch_size: number;\n    embedding_timeout_ms: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\n    mutation_refresh_policy: SearchMutationRefreshPolicy;\n    query_expansion: SearchQueryExpansionSettings;\n    rerank: SearchRerankSettings;\n    tuning?: {\n      title_exact_bonus?: number;\n      title_weight?: number;\n      description_weight?: number;\n      tags_weight?: number;\n      status_weight?: number;\n      body_weight?: number;\n      comments_weight?: number;\n      notes_weight?: number;\n      learnings_weight?: number;\n      dependencies_weight?: number;\n      linked_content_weight?: number;\n    };\n  };\n  providers: {\n    openai: {\n      base_url: string;\n      api_key: string;\n      model: string;\n    };\n    ollama: {\n      base_url: string;\n      model: string;\n    };\n  };\n  context: ContextSettings;\n  vector_store: {\n    adapter?: string;\n    collection_name: string;\n    qdrant: {\n      url: string;\n      api_key: string;\n    };\n    lancedb: {\n      path: string;\n    };\n  };\n}\n"],"names":[],"mappings":"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","debugId":"a6694379-22e4-5b33-9691-cca9ad16865c"}

package/docs/AGENT_GUIDE.md

@@ -109,6 +109,7 @@ pm release <item-id>
 | Full machine payload | `pm get <id> --full --json` |
 | Command flags | `pm <command> --help --json` |
 | Low-noise machine contracts | `pm contracts --command <command> --flags-only --json` |
+| Semantic index refresh | `pm reindex --mode semantic --progress` (stale-first by default; add `--full` to force full rebuild) |
 | Timeline | `pm activity --id <id> --limit 20` |
 | Audited history redaction | `pm history-redact <id> --literal "<secret>" --replacement "[redacted]" --dry-run` |
 | Audited history re-anchor | `pm history-repair <id> --dry-run` (clears drift flagged by `pm health`/`pm validate`) |
@@ -125,12 +126,16 @@ pm release <item-id>
 | Audited bulk close (sprint closeout) | `pm close-many --filter-sprint <s> --reason "<text>" --dry-run` (full `pm close` semantics per item; `--rollback <id>` to undo) |
 | Local docs routing | `pm install guide-shell --project`, then `pm guide <topic>` |
 | Compact mutation echo | `pm --no-changed-fields create "..."` (drops the redundant `changed_fields` array, keeps `changed_field_count`) |
+| Minimal mutation echo | `pm --id-only create "..."` (prints only id and status for single-item mutations) |
+| Duplicate close | `pm close <duplicate> "Duplicate of <canonical>" --duplicate-of <canonical>` |
 
 Default TOON output is preferred for model-readable loops. Use `--json` only when strict parsing is needed.
 
 `list`/`search` compact mode is intentionally token-light: it returns compact items plus only active filters (and runtime schema filters when present), omitting default projection/sorting/now trailer metadata.
 
-Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`, and `pm_run` for `append`/`update-many`) are already compact by default: they return `changed_field_count` instead of the full `changed_fields` array. Pass `options.full=true` only when you need the explicit field-level delta.
+Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_append`/`pm_close`, and `pm_run` for `update-many`) are already compact by default: they return `changed_field_count` instead of the full `changed_fields` array. Pass `fullChangedFields=true` only when you need the explicit field-level delta, or `idOnly=true` for single-item id/status output.
+
+`pm create --parent <id>` fails fast when the parent cannot be found. Use `--allow-missing-parent` only for deliberate imports or staged backlog reconstruction.
 
 ## Guide Routing for Agents
 
@@ -167,6 +172,7 @@ Use these defaults unless the task requires otherwise:
 - `pm schema add-type <Name>` when `pm create`/`pm update` reject a project-specific type as invalid; it registers the type in `.agents/pm/schema/types.json` so `pm create <Name> "..."` works. Built-in types are reserved; the upsert is idempotent. `pm schema remove-type <Name>` removes a custom type (warns, non-blocking, if items still use it).
 - `pm schema add-status <id> --role <role>` / `pm schema remove-status <id>` manage custom lifecycle statuses in `.agents/pm/schema/statuses.json`; roles come from the runtime status-role vocabulary, the upsert is idempotent, and built-in default statuses cannot be removed. `pm schema list` now reports statuses (builtin vs custom) alongside types.
 - `pm init --type-preset agile|ops|research` for new projects that should start with domain item types instead of generic tasks only.
+- After switching embedding provider/model, run `pm reindex --mode semantic --full` or `pm reindex --mode hybrid --full` to rebuild vectors completely; `pm reindex --mode keyword` ignores `--full` and now warns when ledger identity drift is detected.
 - `pm normalize --dry-run --json` before lifecycle metadata cleanups.
 - `pm health --check-only` when inspecting repository health without refresh side effects.
 

package/docs/ARCHITECTURE.md

@@ -292,6 +292,13 @@ node scripts/run-tests.mjs coverage
 
 Linked-test execution also creates sandbox roots and can seed settings/extensions for schema parity. See [Testing](TESTING.md).
 
+Coverage governance is literal all-source under `src/`:
+
+- `vitest.config.ts` coverage include patterns are `src/*.ts` and `src/**/*.ts`.
+- Global thresholds are explicit ratchet baselines for the measured all-source corpus and should only move upward until they reach 100%.
+- Do not maintain a curated include/exclude allowlist for production `src` modules.
+- When a module is hard to test end-to-end (for example CLI orchestration), extract pure logic helpers into small modules and cover those directly instead of weakening thresholds.
+
 ## Terminal Compatibility
 
 Runtime behavior should remain terminal-neutral:

package/docs/CLAUDE_CODE_PLUGIN.md

@@ -65,7 +65,7 @@ This clones the repo, reads `.claude-plugin/marketplace.json` at the root, insta
 claude mcp add --transport stdio pm-mcp -- npx -y --package=@unbrained/pm-cli@latest pm-mcp
 ```
 
-Gives you the 22 MCP tools without skills or slash commands.
+Gives you the 25 MCP tools without skills or slash commands.
 
 ### 3. Direct project `.mcp.json` (project-scoped MCP only)
 
@@ -123,7 +123,7 @@ node scripts/smoke-claude-plugin.mjs
 pnpm smoke:claude-plugin
 ```
 
-Verifies: plugin file structure, manifest name consistency, MCP initialize, 22 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
+Verifies: plugin file structure, manifest name consistency, MCP initialize, 25 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
 
 ### MCP server smoke test
 

package/docs/COMMANDS.md

@@ -23,7 +23,7 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Family | Commands | Purpose |
 |--------|----------|---------|
 | Bootstrap | `init`, `config`, `health`, `telemetry` | create and inspect tracker setup |
-| Triage | `context`, `search`, `list*`, `aggregate`, `dedupe-audit` | find work and audit decomposition |
+| Triage | `context`, `search`, `list*`, `aggregate`, `dedupe-audit`* | find work and audit decomposition |
 | Lifecycle | `create`, `claim`, `update`, `append`, `close`, `release`, `delete`, `start-task`, `pause-task`, `close-task` | mutate item state |
 | Planning | `plan create`, `plan add-step`, `plan update-step`, `plan complete-step`, `plan link`, `plan approve`, `plan materialize` | agent-optimized living plans with ordered steps, evidence, decisions, validation, and materialization |
 | Logs | `comments`, `notes`, `learnings`, `comments-audit` | record progress and durable context |
@@ -35,6 +35,8 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Packages | `install`, `upgrade`, `package`, `packages`, `extension`, package/extension command groups | install, upgrade, manage, and run package-backed extension commands |
 | Machines | `contracts`, `help`, optional `guide`/`completion` | command contracts plus optional guide-shell docs routing and shell helpers |
 
+`*` `dedupe-audit` is provided by the optional `governance-audit` package (`pm install governance-audit --project`).
+
 ## Bootstrap
 
 ```bash
@@ -76,10 +78,14 @@ pm search "calendar reminder validation" --limit 10
 pm list-open --type Task --priority 1 --limit 20
 pm list-in-progress --limit 20
 pm aggregate --group-by parent,type --status open
+pm aggregate --group-by parent,type --completion --include-unparented
+pm install governance-audit --project   # if dedupe-audit is not available
 pm dedupe-audit --mode parent_scope --limit 20
 ```
 
 Use `context` first for a compact active-work snapshot. Use `search` when the request names a concept, component, or prior issue.
+`context` standard/deep views include high-level child completion counters plus `recently_created` and `unparented` sections, so agents can spot new orphan work before creating duplicates.
+Use `pm aggregate --completion` when you need per-group `open`, `in_progress`, `closed`, `other`, and `completion_pct` progress context.
 
 `--sort` accepts `priority|deadline|updated_at|created_at|title|parent`, plus the convenience aliases `updated` (→ `updated_at`) and `created` (→ `created_at`):
 
@@ -204,9 +210,14 @@ Mutation commands (`create`/`update`/`close`/`append`/...) echo a `changed_field
 
 ```bash
 pm --no-changed-fields create "Probe item"   # output keeps changed_field_count, drops the array
+pm --id-only create "Probe item"             # output is only id + status
 ```
 
-Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`/`pm_run` append/update-many) are compact by default; pass `options.full=true` to restore the full `changed_fields` delta.
+Use `pm create --allow-missing-parent --parent <id>` only for deliberate imports or staged backlog reconstruction. Normal `pm create --parent <id>` fails fast when the parent id cannot be resolved.
+
+Use `pm close <duplicate-id> "Duplicate of <canonical-id>" --duplicate-of <canonical-id>` to close duplicates. The command validates the canonical target exists, records `duplicate_of`, and fills the resolution/expected/actual closure fields when they were not provided explicitly.
+
+Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`/`pm_run` append/update-many) are compact by default; pass `fullChangedFields=true` to restore the full `changed_fields` delta, or `idOnly=true` for single-item id/status output.
 
 ## Templates
 
@@ -269,11 +280,16 @@ Linked files and docs keep reviews reproducible. `deps` is read-only and project
 
 ```bash
 pm test <id> --add command="node scripts/run-tests.mjs test -- tests/unit/output.spec.ts",timeout_seconds=240
+pm test <id> --add command "node scripts/run-tests.mjs test -- tests/unit/output.spec.ts"
+pm test <id> --add-json '{"command":"node scripts/run-tests.mjs test -- tests/unit/output.spec.ts","timeout_seconds":240}'
 pm test <id> --run --progress
+pm test <id> --run --match output
+pm test <id> --run --only-index 2
+pm test <id> --run --only-last
 pm test-all --status in_progress --progress
 ```
 
-Linked test commands should be sandbox-safe. Prefer `node scripts/run-tests.mjs ...` because it sets temporary `PM_PATH` and `PM_GLOBAL_PATH`.
+Linked test commands should be sandbox-safe. Prefer `node scripts/run-tests.mjs ...` because it sets temporary `PM_PATH` and `PM_GLOBAL_PATH`. The two-token form `--add command "npm test -- parser"` (and `--add path "..."` / `--remove command "..."`) is accepted when the value is quoted into a single shell argument; it is normalized to `--add command=...` before parsing. Use `--add-json` when command strings contain commas, nested quotes, shell variables, or `--` separators that are awkward to preserve through CSV-style `--add` parsing. `--match`, `--only-index`, and `--only-last` select which linked tests execute without mutating the stored linked-test list.
 
 Strict linked-test guards:
 
@@ -285,12 +301,31 @@ pm test <id> --run \
   --require-assertions-for-pm
 ```
 
+## Search Reindex and Eval
+
+`reindex` is provided by the `search-advanced` package (`pm install search-advanced --project`).
+
+```bash
+pm reindex --mode keyword
+pm reindex --mode semantic
+pm reindex --mode semantic --full
+pm reindex --mode hybrid --progress
+pm reindex --mode keyword --eval --eval-fixtures tests/search-eval/golden-queries.json
+```
+
+- `--mode semantic` and `--mode hybrid` are stale-first by default: only items whose `updated_at` no longer matches `search/vectorization-status.json` are re-embedded.
+- `--full` forces a complete semantic/hybrid re-embed and vector upsert, even when ledger entries are unchanged.
+- Progress now includes a stale-vs-total line so agents can estimate semantic reindex cost before embedding starts.
+- When `pm reindex --mode keyword` detects an embedding provider/model mismatch against the last semantic ledger, it emits a migration warning so agents can run `pm reindex --mode semantic` to rebuild vectors.
+- `--eval` runs the golden-query nDCG@5 harness and appends an `eval` summary to JSON output; `--eval-fixtures` overrides the fixture file path.
+
 ## Calendar and Context
 
 ```bash
 pm calendar --view week --date today --full-period
 pm calendar --from today --to +7d --include deadlines,reminders,events
 pm context --from today --to +7d --limit 10
+pm context --section recently_created --section unparented --limit 10
 ```
 
 `calendar` defaults to markdown for human and agent readability. Other commands default to TOON unless configured otherwise.

package/docs/CONFIGURATION.md

@@ -64,7 +64,7 @@ When `settings.json` cannot be loaded, `pm` falls back to built-in defaults and
 | `history.missing_stream` | `auto_create` or `strict_error` |
 | `testing.record_results_to_items` | persist bounded linked-test summaries |
 | `validation.sprint_release_format` | `warn` or `strict_error` |
-| `validation.parent_reference` | `warn` or `strict_error` |
+| `validation.parent_reference` | `warn` or `strict_error` (`strict_error` is the built-in default; `pm create --allow-missing-parent` is the explicit escape hatch) |
 | `item_types.definitions[]` | custom item types and type options |
 | `governance.create_default_type` | default `--type` used by `pm create "title"` when `--type` is omitted (defaults to `Task`); must resolve to a known item type |
 | `governance.workflow_enforcement` | per-type transition enforcement mode for `pm update --status` (`off` default, `warn`, or `strict`) |