@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/sdk/index.js

@@ -1,3 +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]="1f4bd550-be54-5700-be76-fe6f4fa361a5")}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";
@@ -29,4 +31,5 @@ export { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, E
 export function defineExtension(module) {
     return module;
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map
+//# debugId=1f4bd550-be54-5700-be76-fe6f4fa361a5

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["sdk/index.ts"],"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;AAE7B;;;;;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;AAarH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","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\";\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\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  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  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionLoadResult,\n  ExtensionManifest,\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  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  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"]}
+{"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\";\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\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  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  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionLoadResult,\n  ExtensionManifest,\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  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  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;AAE7B;;;;;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;AAarH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"1f4bd550-be54-5700-be76-fe6f4fa361a5"}

package/dist/sdk/runtime.d.ts

@@ -1,3 +1,5 @@
+import { type ExtensionRegistrationRegistry } from "../core/extensions/index.js";
+import { type ContractsCommandOptions, type ContractsResult } from "../cli/commands/contracts.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
@@ -24,6 +26,28 @@ export { runReindex, type ReindexOptions, type ReindexResult } from "../cli/comm
 export { runSearch, type SearchOptions, type SearchResult } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type CreateTemplateOptions, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, } from "../cli/commands/test-runs.js";
-export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, } from "../types/index.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";
 export type { GlobalOptions } from "../core/shared/command-types.js";
 export type { Dependency, ItemDocument, ItemMetadata, ItemStatus, ItemType, LinkedDoc, LinkedFile, LinkedTest, LogNote, PmSettings, } from "../types/index.js";
+export interface GetContractsOptions extends ContractsCommandOptions {
+    pmRoot?: string;
+    cwd?: string;
+    noExtensions?: boolean;
+    quiet?: boolean;
+    profile?: boolean;
+}
+export interface WorkspaceContractsOptions {
+    extensionRegistrations?: ExtensionRegistrationRegistry | null;
+    noExtensions?: boolean;
+    cwd?: string;
+}
+export interface WorkspaceContracts {
+    types: string[];
+    statuses: string[];
+    openStatus: string;
+    closeStatus: string;
+    canceledStatus: string;
+}
+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,3 +1,10 @@
+
+!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]="052ef5fb-9ab2-5bb7-96b0-f07bab9251b6")}catch(e){}}();
+import { activateExtensions, loadExtensions, } from "../core/extensions/index.js";
+import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
+import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
+import { readSettings } from "../core/store/settings.js";
+import { runContracts, } from "../cli/commands/contracts.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
@@ -24,5 +31,44 @@ export { runReindex } from "../cli/commands/reindex.js";
 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, ISSUE_SEVERITY_VALUES, RISK_VALUES, } from "../types/index.js";
-//# sourceMappingURL=runtime.js.map
+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";
+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));
+    const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
+    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    return {
+        types: [...typeRegistry.types],
+        statuses: statusRegistry.definitions.map((definition) => definition.id),
+        openStatus: statusRegistry.open_status,
+        closeStatus: statusRegistry.close_status,
+        canceledStatus: statusRegistry.canceled_status,
+    };
+}
+export async function getContracts(pmRootOrOptions, options = {}) {
+    const resolvedOptions = typeof pmRootOrOptions === "string"
+        ? { ...options, pmRoot: pmRootOrOptions }
+        : (pmRootOrOptions ?? options);
+    const global = {
+        json: true,
+        quiet: resolvedOptions.quiet ?? true,
+        noExtensions: resolvedOptions.noExtensions ?? false,
+        noPager: true,
+        profile: resolvedOptions.profile ?? false,
+        path: resolvedOptions.pmRoot,
+    };
+    return runContracts(resolvedOptions, global);
+}
+async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
+    const loadResult = await loadExtensions({
+        pmRoot,
+        settings,
+        cwd: cwd ?? process.cwd(),
+        noExtensions: false,
+    });
+    const activationResult = await activateExtensions(loadResult);
+    return activationResult.registrations;
+}
+//# sourceMappingURL=runtime.js.map
+//# debugId=052ef5fb-9ab2-5bb7-96b0-f07bab9251b6

package/dist/sdk/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"/","sources":["sdk/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,GAGZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,QAAQ,GAKT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAA+C,MAAM,+BAA+B,CAAC;AAC3G,OAAO,EACL,gBAAgB,GAOjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,cAAc,GAKf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAsD,MAAM,8BAA8B,CAAC;AAChH,OAAO,EAAE,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,SAAS,EAAyC,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAKjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAKhB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,GACZ,MAAM,mBAAmB,CAAC","sourcesContent":["export {\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 {\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  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  ISSUE_SEVERITY_VALUES,\n  RISK_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"]}
+{"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 {\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  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":"052ef5fb-9ab2-5bb7-96b0-f07bab9251b6"}

package/dist/types/index.js

@@ -1,2 +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]="d522ca2b-e477-529d-b929-4d11de30ae00")}catch(e){}}();
 export * from "../types.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map
+//# debugId=d522ca2b-e477-529d-b929-4d11de30ae00

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC","sourcesContent":["export * from \"../types.js\";\n"]}
+{"version":3,"file":"index.js","sources":["types/index.ts"],"sourceRoot":"/","sourcesContent":["export * from \"../types.js\";\n"],"names":[],"mappings":";;AAAA,cAAc,aAAa,CAAC","debugId":"d522ca2b-e477-529d-b929-4d11de30ae00"}

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-export declare const BUILTIN_ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting"];
-export declare const ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting"];
+export declare const BUILTIN_ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting", "Plan"];
+export declare const ITEM_TYPE_VALUES: readonly ["Epic", "Feature", "Task", "Chore", "Issue", "Decision", "Event", "Reminder", "Milestone", "Meeting", "Plan"];
 export type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];
 export type ItemType = string;
 export declare const STATUS_VALUES: readonly ["draft", "open", "in_progress", "blocked", "closed", "canceled"];
@@ -45,6 +45,12 @@ export declare const RECURRENCE_FREQUENCY_VALUES: readonly ["daily", "weekly", "
 export type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];
 export declare const RECURRENCE_WEEKDAY_VALUES: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
 export type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];
+/**
+ * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).
+ * Shared by item serialization, create/update parsing, and calendar expansion
+ * so weekday ordering cannot drift between those modules.
+ */
+export declare function weekdayOrderIndex(value: RecurrenceWeekday): number;
 export interface Dependency {
     id: string;
     kind: DependencyKind;
@@ -113,6 +119,72 @@ export interface CalendarEvent {
     timezone?: string;
     recurrence?: RecurrenceRule;
 }
+export declare const PLAN_MODE_VALUES: readonly ["draft", "research", "review", "approved", "executing", "paused", "completed", "superseded"];
+export type PlanMode = (typeof PLAN_MODE_VALUES)[number];
+export declare const PLAN_STEP_STATUS_VALUES: readonly ["pending", "in_progress", "completed", "blocked", "skipped", "superseded"];
+export type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];
+export declare const PLAN_HARNESS_VALUES: readonly ["codex", "claude-code", "cursor", "generic"];
+export type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];
+export declare const PLAN_STEP_LINK_KIND_VALUES: readonly ["related", "blocks", "blocked_by", "depends_on", "discovered_from", "implements", "verifies", "supersedes"];
+export type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];
+export interface PlanStepLink {
+    id: string;
+    kind: PlanStepLinkKind;
+    note?: string;
+    required_before_step?: boolean;
+}
+export interface PlanStepFile {
+    path: string;
+    scope?: LinkScope;
+    note?: string;
+}
+export interface PlanStepTest {
+    command?: string;
+    path?: string;
+    note?: string;
+}
+export interface PlanStepDoc {
+    path: string;
+    scope?: LinkScope;
+    note?: string;
+}
+export interface PlanStep {
+    id: string;
+    order: number;
+    title: string;
+    body?: string;
+    status: PlanStepStatus;
+    owner?: string;
+    evidence?: string;
+    blocked_reason?: string;
+    superseded_by?: string;
+    linked_items?: PlanStepLink[];
+    files?: PlanStepFile[];
+    tests?: PlanStepTest[];
+    docs?: PlanStepDoc[];
+    created_at: string;
+    updated_at: string;
+    completed_at?: string;
+}
+export interface PlanDecision {
+    ts: string;
+    author: string;
+    decision: string;
+    rationale?: string;
+    evidence?: string;
+    step_id?: string;
+}
+export interface PlanDiscovery {
+    ts: string;
+    author: string;
+    text: string;
+    step_id?: string;
+}
+export interface PlanValidationCheck {
+    text: string;
+    command?: string;
+    expected?: string;
+}
 export interface ItemTypeOptionDefinition {
     key: string;
     values: string[];
@@ -260,6 +332,14 @@ export interface ItemMetadata {
     test_runs?: ItemTestRunSummary[];
     docs?: LinkedDoc[];
     close_reason?: string;
+    plan_mode?: PlanMode;
+    plan_scope?: string;
+    plan_harness?: PlanHarness;
+    plan_steps?: PlanStep[];
+    plan_decisions?: PlanDecision[];
+    plan_discoveries?: PlanDiscovery[];
+    plan_validation?: PlanValidationCheck[];
+    plan_resume_context?: string;
     [key: string]: unknown;
 }
 /**
@@ -313,6 +393,7 @@ export interface GovernanceSettings {
     parent_reference: ParentReferencePolicy;
     metadata_profile: ValidateMetadataProfile;
     force_required_for_stale_lock: boolean;
+    create_default_type?: string;
 }
 export type ExtensionPolicyMode = "off" | "warn" | "enforce";
 export type ExtensionTrustMode = "off" | "warn" | "enforce";
@@ -354,6 +435,13 @@ export interface ExtensionPolicySettings {
     blocked_services: string[];
     extension_overrides: ExtensionPolicyOverrideSettings[];
 }
+export interface AgentGuidanceSettings {
+    prompt_completed: boolean;
+    declined: boolean;
+    declined_at: string;
+    template_version: number;
+    last_checked_files: string[];
+}
 export interface PmSettings {
     version: number;
     id_prefix: string;
@@ -393,6 +481,7 @@ export interface PmSettings {
         installation_id: string;
         retention_days: number;
     };
+    agent_guidance: AgentGuidanceSettings;
     item_types: {
         definitions: ItemTypeDefinition[];
     };
@@ -408,6 +497,7 @@ export interface PmSettings {
         max_results: number;
         embedding_model: string;
         embedding_batch_size: number;
+        embedding_timeout_ms: number;
         scanner_max_batch_retries: number;
         provider?: string;
         tuning?: {

package/dist/types.js

@@ -1,3 +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]="68c1fa65-9fc4-5566-9c23-bdb17c35cb53")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -9,6 +11,7 @@ export const BUILTIN_ITEM_TYPE_VALUES = [
     "Reminder",
     "Milestone",
     "Meeting",
+    "Plan",
 ];
 export const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;
 export const STATUS_VALUES = [
@@ -73,6 +76,43 @@ export const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [
 ];
 export const RECURRENCE_FREQUENCY_VALUES = ["daily", "weekly", "monthly", "yearly"];
 export const RECURRENCE_WEEKDAY_VALUES = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+/**
+ * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).
+ * Shared by item serialization, create/update parsing, and calendar expansion
+ * so weekday ordering cannot drift between those modules.
+ */
+export function weekdayOrderIndex(value) {
+    return RECURRENCE_WEEKDAY_VALUES.indexOf(value);
+}
+export const PLAN_MODE_VALUES = [
+    "draft",
+    "research",
+    "review",
+    "approved",
+    "executing",
+    "paused",
+    "completed",
+    "superseded",
+];
+export const PLAN_STEP_STATUS_VALUES = [
+    "pending",
+    "in_progress",
+    "completed",
+    "blocked",
+    "skipped",
+    "superseded",
+];
+export const PLAN_HARNESS_VALUES = ["codex", "claude-code", "cursor", "generic"];
+export const PLAN_STEP_LINK_KIND_VALUES = [
+    "related",
+    "blocks",
+    "blocked_by",
+    "depends_on",
+    "discovered_from",
+    "implements",
+    "verifies",
+    "supersedes",
+];
 export const CONTEXT_DEPTH_VALUES = ["brief", "standard", "deep"];
 export const CONTEXT_SECTION_VALUES = [
     "hierarchy",
@@ -84,4 +124,5 @@ export const CONTEXT_SECTION_VALUES = [
     "staleness",
     "tests",
 ];
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map
+//# debugId=68c1fa65-9fc4-5566-9c23-bdb17c35cb53

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"/","sources":["types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,UAAU;IACV,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;CACD,CAAC;AACX,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAIzD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO;IACP,MAAM;IACN,aAAa;IACb,SAAS;IACT,QAAQ;IACR,UAAU;CACF,CAAC;AAGX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,eAAe;IACf,mBAAmB;IACnB,cAAc;IACd,eAAe;IACf,gBAAgB;CACR,CAAC;AAGX,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAU,CAAC;AAGlG,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAGlI,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAGxF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,cAAc;IACd,UAAU;IACV,SAAS;IACT,YAAY;IACZ,iBAAiB;IACjB,YAAY;IACZ,eAAe;IACf,MAAM;IACN,YAAY;IACZ,MAAM;CACE,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAGpF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAIzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,eAAe,CAAU,CAAC;AAGrE,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAU,CAAC;AAErF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAM,EAAE,cAAc,CAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAE5F,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE3F,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAU,CAAC;AAExF,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE7F,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,QAAQ;IACR,qBAAqB;IACrB,mBAAmB;IACnB,cAAc;IACd,UAAU;IACV,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,SAAS;CACD,CAAC;AAGX,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AA0QpG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAG3E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,UAAU;IACV,UAAU;IACV,UAAU;IACV,OAAO;IACP,UAAU;IACV,WAAW;IACX,OAAO;CACC,CAAC","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] 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 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\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 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  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\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\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?: \"low\" | \"medium\" | \"high\" | \"critical\";\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  [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  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\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 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  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_batch_size: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\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    qdrant: {\n      url: string;\n      api_key: string;\n    };\n    lancedb: {\n      path: string;\n    };\n  };\n}\n"]}
+{"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 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  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\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\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?: \"low\" | \"medium\" | \"high\" | \"critical\";\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  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\n  create_default_type?: string;\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 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_batch_size: number;\n    embedding_timeout_ms: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\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    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":"68c1fa65-9fc4-5566-9c23-bdb17c35cb53"}

package/docs/AGENT_GUIDE.md

@@ -11,10 +11,13 @@ pm context --limit 10
 pm search "<request keywords>" --limit 10
 pm list-open --limit 20
 pm list-in-progress --limit 20
+pm init --agent-guidance status
+pm install guide-shell --project
 pm guide workflows
 ```
 
 If a relevant item exists, reuse it. If not, create a parent lineage, then create and claim the child implementation item.
+When AGENTS/CLAUDE guidance is missing, use `pm init --agent-guidance add` to inject compact workflow guardrails, or `pm init --agent-guidance skip` to persist an explicit decline.
 
 Tracked documentation work: [pm-3042](../.agents/pm/epics/pm-3042.toon), [pm-r9gu](../.agents/pm/features/pm-r9gu.toon), [pm-1sb2](../.agents/pm/tasks/pm-1sb2.toon).
 
@@ -37,10 +40,12 @@ pm create --create-mode progressive \
   --description "..." \
   --type Epic \
   --status open \
-  --priority 1 \
+  --priority high \
   --comment "author=$PM_AUTHOR,created_at=now,text=Duplicate check evidence: ..."
 ```
 
+Priority accepts either numeric `0..4` or named aliases `critical`, `high`, `medium`, `low`, and `minimal`.
+
 Create hierarchy from broad to narrow: `Epic` -> `Feature` -> `Task` or `Issue`. Use `--parent <id>` for child items.
 
 3. **Claim**
@@ -60,9 +65,9 @@ pm append <item-id> --body "Implementation notes..."
 5. **Link execution context**
 
 ```bash
-pm files <item-id> --add path=src/app.ts,scope=project,note="entrypoint"
-pm docs <item-id> --add path=docs/COMMANDS.md,scope=project,note="public docs"
-pm test <item-id> --add command="node scripts/run-tests.mjs test -- tests/unit/app.spec.ts",scope=project,timeout_seconds=240
+pm files <item-id> --add path=src/app.ts,note="entrypoint"
+pm docs <item-id> --add path=docs/COMMANDS.md,note="public docs"
+pm test <item-id> --add command="node scripts/run-tests.mjs test -- tests/unit/app.spec.ts",timeout_seconds=240
 ```
 
 6. **Record progress**
@@ -94,16 +99,24 @@ pm release <item-id>
 | Command flags | `pm <command> --help --json` |
 | Low-noise machine contracts | `pm contracts --command <command> --flags-only --json` |
 | 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`) |
+| Register custom item type | `pm schema add-type <Name> --description "<text>" --default-status open` (then `pm create <Name> "..."`) |
+| Agent plan create | `pm plan create --title "<scope>" --harness claude-code --scope "<short>" --claim` |
+| Agent plan step update | `pm plan update-step <plan-id> plan-step-001 --step-status in_progress --step-evidence "<short>"` |
+| Agent plan read | `pm plan show <plan-id> --depth brief` (or `--fields id,title,steps_summary`) |
+| Materialize plan steps | `pm plan materialize <plan-id> --steps plan-step-002 --materialize-type Task` |
 | Dependencies | `pm deps <id> --format tree` |
-| Local docs routing | `pm guide <topic>` |
+| Local docs routing | `pm install guide-shell --project`, then `pm guide <topic>` |
 
 Default TOON output is preferred for model-readable loops. Use `--json` only when strict parsing is needed.
 
 ## Guide Routing for Agents
 
-Use `pm guide` as the local progressive-disclosure router before opening large documents:
+Use `pm guide` as the local progressive-disclosure router after installing the optional `guide-shell` package:
 
 ```bash
+pm install guide-shell --project
 pm guide
 pm guide quickstart
 pm guide commands --depth standard
@@ -123,7 +136,7 @@ pm guide release --json
 
 - Keep [README](../README.md) short.
 - Put details in focused docs under `docs/`.
-- Keep reusable workflow prompts in `.agents/skills/*` and route via `pm guide skills`.
+- Keep reusable workflow prompts in `.agents/skills/*` and route via `pm guide skills` after `guide-shell` is installed.
 - Use relative links such as `[Command Reference](COMMANDS.md)`.
 - Add tracker references near the top of new docs when a task created the change.
 - Link docs back to the active item with `pm docs`.
@@ -136,5 +149,8 @@ Use these defaults unless the task requires otherwise:
 - `PM_AUTHOR=<stable-agent-name>` for mutations.
 - `node scripts/run-tests.mjs test` and `node scripts/run-tests.mjs coverage` for tests.
 - `pm validate --check-resolution --check-history-drift` before closing broad work.
+- `pm history-redact <id> --dry-run` before rewriting sensitive history payloads, then rerun without `--dry-run` once scope is confirmed.
+- `pm history-repair <id> --dry-run` when `pm health` or `pm validate --check-history-drift` report drifted streams; it re-anchors the hash chain and reconciles with the on-disk item without touching item content. Rerun without `--dry-run` to apply.
+- `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 normalize --dry-run --json` before lifecycle metadata cleanups.
 - `pm health --check-only` when inspecting repository health without refresh side effects.

package/docs/ARCHITECTURE.md

@@ -181,7 +181,7 @@ History entries are append-only JSONL records:
 Useful diagnostics:
 
 ```bash
-pm history <id> --diff --verify
+pm history <id> --full --diff --verify
 pm activity --id <id> --limit 50
 pm validate --check-history-drift
 ```