@unbrained/pm-cli 2026.7.3 → 2026.7.4

package/dist/cli-bundle/chunks/chunk-JYLFF7GJ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/init.ts", "../../../../../../../../cli/commands/init-agent-guidance.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/init\n *\n * Implements the pm init command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { normalizePrefix } from \"../../core/item/id.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport {\n  DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,\n  ensureRuntimeSchemaFileScaffold,\n  filePathForSchemaSection,\n  normalizeRuntimeSchemaSettings,\n} from \"../../core/schema/runtime-schema.js\";\nimport {\n  parseItemTypesFile,\n  serializeItemTypesFile,\n  upsertItemType,\n} from \"../../core/schema/item-types-file.js\";\nimport {\n  normalizeTypePresetName,\n  resolveTypePresetDefinitions,\n  TYPE_PRESET_NAMES,\n  type TypePresetName,\n} from \"../../core/schema/type-presets.js\";\nimport { EXIT_CODE, GOVERNANCE_PRESET_DEFAULTS, PM_REQUIRED_SUBDIRS, SETTINGS_DEFAULTS } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings, writeSettings } from \"../../core/store/settings.js\";\nimport type { GovernancePreset, PmSettings } from \"../../types/index.js\";\nimport { runExtension, type ExtensionCommandResult } from \"./extension.js\";\nimport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n} from \"./init-agent-guidance.js\";\n\n/**\n * Documents the init installed packages summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface InitInstalledPackagesSummary {\n  installed_all: boolean;\n  installed_count: number;\n  packages: Array<{\n    alias: string;\n    ok: boolean;\n  }>;\n}\n\n/**\n * Restricts init type preset name values accepted by command, SDK, and storage contracts.\n */\nexport type InitTypePresetName = TypePresetName;\n\n/**\n * Documents the init registered type preset summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface InitRegisteredTypePresetSummary {\n  name: InitTypePresetName;\n  registered: string[];\n  updated: string[];\n  file: string;\n}\n\n/**\n * Documents the init agent-guidance summary plus generated next-step hints returned by init.\n */\nexport type InitAgentGuidanceResult = InitAgentGuidanceSummary & { next_steps: string[] };\n\n/**\n * Documents the init result payload exchanged by command, SDK, and package integrations.\n */\nexport interface InitResult {\n  ok: boolean;\n  path: string;\n  settings: PmSettings;\n  created_dirs: string[];\n  warnings: string[];\n  governance_preset: GovernancePreset;\n  wizard_used: boolean;\n  registered_type_preset?: InitRegisteredTypePresetSummary;\n  installed_packages?: InitInstalledPackagesSummary;\n  next_steps: string[];\n  agent_guidance: InitAgentGuidanceResult;\n}\n\n/**\n * Documents the init command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface InitCommandOptions {\n  preset?: string;\n  defaults?: boolean;\n  author?: string;\n  withPackages?: boolean;\n  agentGuidance?: string;\n  typePreset?: string;\n  force?: boolean;\n}\n\n/**\n * Concise projection of an InitResult for the default (toon) renderer. It keeps\n * every piece of information that only init can surface — the resolved path, id\n * prefix, governance preset, telemetry capture level, created-directory count,\n * the full warnings list (including `already_exists:` markers), agent-guidance\n * summary, and next steps — but replaces the verbose full settings tree (~190\n * lines) with a compact `settings` summary. Use --verbose for the full tree.\n */\nexport interface InitConciseResult {\n  ok: boolean;\n  path: string;\n  id_prefix: string;\n  governance_preset: GovernancePreset;\n  telemetry: {\n    enabled: boolean;\n    capture_level: string;\n  };\n  output_format: string;\n  created_dirs_count: number;\n  created_dirs: string[];\n  warnings: string[];\n  wizard_used: boolean;\n  registered_type_preset?: InitRegisteredTypePresetSummary;\n  installed_packages?: InitInstalledPackagesSummary;\n  next_steps: string[];\n  agent_guidance: InitAgentGuidanceResult;\n  hint: string;\n}\n\n/**\n * Implements summarize init result for the public runtime surface of this module.\n */\nexport function summarizeInitResult(result: InitResult): InitConciseResult {\n  return {\n    ok: result.ok,\n    path: result.path,\n    id_prefix: result.settings.id_prefix,\n    governance_preset: result.governance_preset,\n    telemetry: {\n      enabled: result.settings.telemetry.enabled,\n      capture_level: result.settings.telemetry.capture_level,\n    },\n    output_format: result.settings.output.default_format,\n    created_dirs_count: result.created_dirs.length,\n    created_dirs: result.created_dirs,\n    warnings: result.warnings,\n    wizard_used: result.wizard_used,\n    ...(result.registered_type_preset ? { registered_type_preset: result.registered_type_preset } : {}),\n    ...(result.installed_packages ? { installed_packages: result.installed_packages } : {}),\n    next_steps: result.next_steps,\n    agent_guidance: result.agent_guidance,\n    hint: \"Re-run with --verbose for the full settings tree.\",\n  };\n}\n\nexport const _testOnly = {\n  normalizeInitGovernancePreset,\n  normalizeInitTypePreset,\n  normalizeOptionalInitAuthor,\n  normalizeInitAgentGuidanceMode,\n  isPathLikeInitTarget,\n  resolveInitInvocation,\n  parseYesNoChoice,\n  applyGovernancePreset,\n  runInitWizard,\n  setInitReadlineFactoryForTests,\n  summarizeInstalledPackages,\n  registerInitTypePreset,\n  assertExplicitTrackerPathIsNotWorkspaceRoot,\n  isLikelyWorkspaceRoot,\n};\n\ntype InitReadlineInterface = ReturnType<typeof readline.createInterface>;\nlet createInitReadlineInterface = (): InitReadlineInterface => readline.createInterface({ input, output });\n\ninterface InitNormalizedOptions {\n  presetFromOption: BuiltinGovernancePreset | undefined;\n  useDefaults: boolean;\n  authorFromOption: string | undefined;\n  installBundledPackages: boolean;\n  agentGuidanceMode: InitAgentGuidanceMode;\n  typePreset: InitTypePresetName | undefined;\n}\n\ninterface InitSettingsResolution {\n  settings: PmSettings;\n  normalizedPrefix: string;\n  chosenPreset: BuiltinGovernancePreset | undefined;\n  wizardUsed: boolean;\n}\n\nfunction setInitReadlineFactoryForTests(factory: (() => InitReadlineInterface) | undefined): void {\n  createInitReadlineInterface = factory ?? (() => readline.createInterface({ input, output }));\n}\n\nfunction cloneDefaults(): PmSettings {\n  return structuredClone(SETTINGS_DEFAULTS);\n}\n\ntype BuiltinGovernancePreset = Exclude<GovernancePreset, \"custom\">;\nconst BUILTIN_GOVERNANCE_PRESETS: BuiltinGovernancePreset[] = [\"minimal\", \"default\", \"strict\"];\nfunction normalizeInitGovernancePreset(rawValue: string | undefined): BuiltinGovernancePreset | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  const normalized = rawValue.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\"--preset must not be empty\", EXIT_CODE.USAGE);\n  }\n  if (normalized === \"minimal\" || normalized === \"default\" || normalized === \"strict\") {\n    return normalized;\n  }\n  if (normalized === \"lite\" || normalized === \"minimum\") {\n    return \"minimal\";\n  }\n  throw new PmCliError(\n    `Invalid --preset value \"${rawValue}\". Allowed: ${BUILTIN_GOVERNANCE_PRESETS.join(\", \")}`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction normalizeInitTypePreset(rawValue: string | undefined): InitTypePresetName | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  if (rawValue.trim().length === 0) {\n    throw new PmCliError(\"--type-preset must not be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    // Non-undefined input never returns undefined; the shared normalizer throws\n    // a plain Error for empty/unknown values, which we re-map to init's --type-preset\n    // PmCliError wording for a consistent CLI surface.\n    return normalizeTypePresetName(rawValue) as InitTypePresetName;\n  } catch {\n    throw new PmCliError(\n      `Invalid --type-preset value \"${rawValue}\". Allowed: ${TYPE_PRESET_NAMES.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction normalizeOptionalInitAuthor(rawValue: string | undefined): string | undefined {\n  if (rawValue === undefined) {\n    return undefined;\n  }\n  const normalized = rawValue.trim();\n  if (normalized.length === 0) {\n    throw new PmCliError(\"--author must not be empty\", EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\nfunction isPathLikeInitTarget(rawValue: string | undefined): boolean {\n  if (rawValue === undefined) {\n    return false;\n  }\n  const trimmed = rawValue.trim();\n  if (trimmed.length === 0) {\n    return false;\n  }\n  return path.isAbsolute(trimmed) || trimmed.startsWith(\".\") || trimmed.includes(\"/\") || trimmed.includes(\"\\\\\");\n}\n\nfunction resolveInitInvocation(\n  cwd: string,\n  global: GlobalOptions,\n  prefixArg: string | undefined,\n): { pmRoot: string; prefixArg: string | undefined; positional_target?: string } {\n  if (global.path === undefined && isPathLikeInitTarget(prefixArg)) {\n    const positionalTarget = path.resolve(cwd, prefixArg!.trim());\n    return {\n      pmRoot: positionalTarget,\n      prefixArg: undefined,\n      positional_target: positionalTarget,\n    };\n  }\n  return {\n    pmRoot: resolvePmRoot(cwd, global.path),\n    prefixArg,\n  };\n}\n\nfunction normalizeInitAgentGuidanceMode(rawValue: string | undefined): InitAgentGuidanceMode {\n  if (rawValue === undefined) {\n    return \"ask\";\n  }\n  const normalized = rawValue.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized.length === 0) {\n    throw new PmCliError(\"--agent-guidance must not be empty\", EXIT_CODE.USAGE);\n  }\n  if (normalized === \"ask\" || normalized === \"add\" || normalized === \"skip\" || normalized === \"status\") {\n    return normalized;\n  }\n  throw new PmCliError(\n    `Invalid --agent-guidance value \"${rawValue}\". Allowed: ${INIT_AGENT_GUIDANCE_MODE_VALUES.join(\", \")}`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction parseYesNoChoice(answer: string, currentDefault: boolean): boolean {\n  const normalized = answer.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return currentDefault;\n  }\n  if (normalized === \"y\" || normalized === \"yes\") {\n    return true;\n  }\n  if (normalized === \"n\" || normalized === \"no\") {\n    return false;\n  }\n  return currentDefault;\n}\n\nfunction applyGovernancePreset(settings: PmSettings, preset: BuiltinGovernancePreset): void {\n  const knobs = GOVERNANCE_PRESET_DEFAULTS[preset];\n  settings.governance = {\n    preset,\n    ...knobs,\n  };\n  settings.validation.parent_reference = knobs.parent_reference;\n  settings.validation.metadata_profile = knobs.metadata_profile;\n}\n\nfunction isInstalledPackageEntry(value: unknown): value is { alias?: unknown; ok?: unknown } {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction summarizeInstalledPackages(result: ExtensionCommandResult): InitInstalledPackagesSummary {\n  const details = result.details as {\n    installed_all?: unknown;\n    installed_count?: unknown;\n    packages?: Array<{\n      alias?: unknown;\n      ok?: unknown;\n    }>;\n  };\n  return {\n    installed_all: details.installed_all === true,\n    installed_count: typeof details.installed_count === \"number\" ? details.installed_count : 0,\n    packages: Array.isArray(details.packages)\n      ? details.packages.filter(isInstalledPackageEntry).map((entry) => ({\n          alias: typeof entry.alias === \"string\" ? entry.alias : \"\",\n          ok: entry.ok === true,\n        }))\n      : [],\n  };\n}\n\nasync function registerInitTypePreset(\n  pmRoot: string,\n  settings: PmSettings,\n  preset: InitTypePresetName,\n): Promise<InitRegisteredTypePresetSummary> {\n  const schema = normalizeRuntimeSchemaSettings(settings.schema);\n  const typesPath = filePathForSchemaSection(pmRoot, schema.files.types, DEFAULT_RUNTIME_SCHEMA_FILE_PATHS.types);\n  const parsed = parseItemTypesFile(await readFileIfExists(typesPath));\n  let nextFile = parsed;\n  const registered: string[] = [];\n  const updated: string[] = [];\n  for (const normalized of resolveTypePresetDefinitions(preset)) {\n    const upsert = upsertItemType(nextFile, normalized);\n    nextFile = upsert.file;\n    (upsert.replaced ? updated : registered).push(upsert.definition.name);\n  }\n  await writeFileAtomic(typesPath, serializeItemTypesFile(nextFile));\n  return {\n    name: preset,\n    registered,\n    updated,\n    file: typesPath,\n  };\n}\n\nasync function isLikelyWorkspaceRoot(candidate: string): Promise<boolean> {\n  const indicators = [\n    \".git\",\n    \"package.json\",\n    \"pnpm-workspace.yaml\",\n    \"AGENTS.md\",\n    path.join(\".agents\", \"pm\"),\n  ];\n  for (const indicator of indicators) {\n    if (await pathExists(path.join(candidate, indicator))) {\n      return true;\n    }\n  }\n  return false;\n}\n\nasync function assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot: string, global: GlobalOptions, force: boolean): Promise<void> {\n  if (global.path === undefined || force) {\n    return;\n  }\n  if (await pathExists(path.join(pmRoot, \"settings.json\"))) {\n    return;\n  }\n  if (!(await isLikelyWorkspaceRoot(pmRoot))) {\n    return;\n  }\n  const nestedTracker = path.join(pmRoot, \".agents\", \"pm\");\n  throw new PmCliError(\n    `Refusing to initialize tracker files directly in workspace root \"${pmRoot}\".`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"workspace_root_pm_path\",\n      type: \"urn:pm-cli:error:workspace_root_pm_path\",\n      why: \"--pm-path/--path points at the tracker storage directory itself, not the repository workspace. Point it at .agents/pm or pass --force if you intentionally want root-level tracker files.\",\n      examples: [\n        `pm --pm-path ${nestedTracker} init --yes`,\n        \"pm init --yes\",\n        `pm --pm-path ${pmRoot} init --yes --force`,\n      ],\n      nextSteps: [\n        \"Use --pm-path <repo>/.agents/pm for repository-local tracker storage.\",\n        \"Use PM_PATH only for sandboxed tests or explicit tracker roots.\",\n        \"Pass --force only when root-level tracker files are intentional.\",\n      ],\n      recovery: {\n        next_best_command: `pm --pm-path ${nestedTracker} init --yes`,\n      },\n    },\n  );\n}\n\nasync function ensureInitDirectories(pmRoot: string, subdirs: readonly string[]): Promise<{\n  createdDirs: string[];\n  warnings: string[];\n}> {\n  const createdDirs: string[] = [];\n  const warnings: string[] = [];\n  for (const subdir of subdirs) {\n    const target = subdir ? path.join(pmRoot, subdir) : pmRoot;\n    const existed = await pathExists(target);\n    await fs.mkdir(target, { recursive: true });\n    if (existed) {\n      warnings.push(`already_exists:${target}`);\n    } else {\n      createdDirs.push(target);\n    }\n    warnings.push(\n      ...(await runActiveOnWriteHooks({\n        path: target,\n        scope: \"project\",\n        op: \"init:ensure_dir\",\n      })),\n    );\n  }\n  return { createdDirs, warnings };\n}\n\nasync function runInitWizard(initialPrefix: string, telemetryDefault: boolean): Promise<{\n  prefix: string;\n  preset: BuiltinGovernancePreset;\n  telemetry_enabled: boolean;\n}> {\n  const rl = createInitReadlineInterface();\n  try {\n    output.write(\"pm init setup wizard (agent-optimized)\\n\");\n    output.write(\"This walkthrough is non-destructive and each choice can be changed later with pm config.\\n\\n\");\n\n    output.write(\"1/3 Item ID prefix\\n\");\n    output.write(\"Prefix is prepended to generated IDs (for example pm-a1b2).\\n\");\n    const prefixAnswer = await rl.question(`Item ID prefix [${initialPrefix}]: `);\n    const resolvedPrefix = prefixAnswer.trim().length > 0 ? normalizePrefix(prefixAnswer) : initialPrefix;\n\n    output.write(\"\\n2/3 Governance preset\\n\");\n    output.write(\"minimal: no ownership blocking, progressive create defaults, close validation off.\\n\");\n    output.write(\"default: ownership conflict warnings, progressive create defaults, close validation warn.\\n\");\n    output.write(\"strict: ownership blocking, strict create defaults, close validation strict.\\n\");\n    const presetAnswer = await rl.question(\"Governance preset [minimal/default/strict] (default: minimal): \");\n    const presetChoice = presetAnswer.trim().length > 0 ? presetAnswer.trim() : \"minimal\";\n    // The wizard is forgiving: a typo'd/unknown preset defaults to minimal with a\n    // notice instead of throwing and aborting an in-progress interactive setup.\n    // normalizeInitGovernancePreset returns a concrete preset for valid input and\n    // throws (never returns undefined) for invalid non-empty input, so the result is\n    // always a BuiltinGovernancePreset on the success path.\n    let resolvedPreset: BuiltinGovernancePreset = \"minimal\";\n    try {\n      resolvedPreset = normalizeInitGovernancePreset(presetChoice) as BuiltinGovernancePreset;\n    } catch {\n      output.write(`Unrecognized governance preset \"${presetChoice}\"; using minimal.\\n`);\n    }\n\n    output.write(\"\\n3/3 Project telemetry\\n\");\n    output.write(\"Telemetry helps improve reliability and can be disabled anytime via pm config.\\n\");\n    const telemetryLabel = telemetryDefault ? \"Y/n\" : \"y/N\";\n    const telemetryAnswer = await rl.question(`Enable telemetry for this project? [${telemetryLabel}] `);\n    const telemetryEnabled = parseYesNoChoice(telemetryAnswer, telemetryDefault);\n\n    output.write(\"\\n\");\n    return {\n      prefix: resolvedPrefix,\n      preset: resolvedPreset,\n      telemetry_enabled: telemetryEnabled,\n    };\n  } finally {\n    rl.close();\n  }\n}\n\nfunction normalizeInitCommandOptions(options: InitCommandOptions): InitNormalizedOptions {\n  return {\n    presetFromOption: normalizeInitGovernancePreset(options.preset),\n    useDefaults: options.defaults === true,\n    authorFromOption: normalizeOptionalInitAuthor(options.author),\n    installBundledPackages: options.withPackages === true,\n    agentGuidanceMode: normalizeInitAgentGuidanceMode(options.agentGuidance),\n    typePreset: normalizeInitTypePreset(options.typePreset),\n  };\n}\n\nfunction collectExistingSettingsPendingChanges(params: {\n  settings: PmSettings;\n  normalizedPrefix: string;\n  prefixArg: string | undefined;\n  presetFromOption: BuiltinGovernancePreset | undefined;\n  authorFromOption: string | undefined;\n}): string[] {\n  const pendingChanges: string[] = [];\n  if (params.prefixArg !== undefined && params.settings.id_prefix !== params.normalizedPrefix) {\n    pendingChanges.push(\"id_prefix\");\n  }\n  if (params.presetFromOption !== undefined && params.settings.governance.preset !== params.presetFromOption) {\n    pendingChanges.push(\"governance_preset\");\n  }\n  if (params.authorFromOption !== undefined && params.settings.author_default !== params.authorFromOption) {\n    pendingChanges.push(\"author_default\");\n  }\n  return pendingChanges;\n}\n\nfunction assertExistingSettingsUpdateAllowed(settingsPath: string, pendingChanges: string[], force: boolean): void {\n  if (pendingChanges.length === 0 || force) {\n    return;\n  }\n  throw new PmCliError(\n    `Refusing to update existing tracker settings at ${settingsPath} without --force.`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"init_existing_settings_requires_force\",\n      type: \"urn:pm-cli:error:init_existing_settings_requires_force\",\n      required: `--force for ${pendingChanges.join(\", \")}`,\n      why: \"pm init is safe to rerun, but changing id prefix, governance preset, or default author on an existing tracker can corrupt long-lived project context when an agent meant to initialize a sandbox path.\",\n      examples: [\n        \"pm init --yes\",\n        \"pm init ./sandbox-pm --yes\",\n        \"pm init acme --yes --force\",\n      ],\n      nextSteps: [\n        \"If you meant to initialize a sandbox tracker, pass a path-like positional such as ./sandbox-pm or /tmp/pm-test.\",\n        \"If you intentionally want to rewrite this existing tracker's init-managed settings, rerun with --force.\",\n      ],\n    },\n  );\n}\n\nfunction applyExistingSettingsUpdates(params: {\n  settings: PmSettings;\n  normalizedPrefix: string;\n  prefixArg: string | undefined;\n  presetFromOption: BuiltinGovernancePreset | undefined;\n  authorFromOption: string | undefined;\n  warnings: string[];\n}): boolean {\n  let changed = false;\n  if (params.prefixArg !== undefined && params.settings.id_prefix !== params.normalizedPrefix) {\n    params.settings.id_prefix = params.normalizedPrefix;\n    params.warnings.push(`updated:id_prefix:${params.normalizedPrefix}`);\n    changed = true;\n  }\n  if (params.presetFromOption !== undefined && params.settings.governance.preset !== params.presetFromOption) {\n    applyGovernancePreset(params.settings, params.presetFromOption);\n    params.warnings.push(`updated:governance_preset:${params.presetFromOption}`);\n    changed = true;\n  }\n  if (params.authorFromOption !== undefined && params.settings.author_default !== params.authorFromOption) {\n    params.settings.author_default = params.authorFromOption;\n    params.warnings.push(`updated:author_default:${params.authorFromOption}`);\n    changed = true;\n  }\n  return changed;\n}\n\nasync function loadExistingInitSettings(params: {\n  pmRoot: string;\n  settingsPath: string;\n  normalizedPrefix: string;\n  prefixArg: string | undefined;\n  options: InitCommandOptions;\n  normalizedOptions: InitNormalizedOptions;\n  warnings: string[];\n}): Promise<InitSettingsResolution> {\n  const settings = await readSettings(params.pmRoot);\n  params.warnings.push(`already_exists:${params.settingsPath}`);\n  const pendingChanges = collectExistingSettingsPendingChanges({\n    settings,\n    normalizedPrefix: params.normalizedPrefix,\n    prefixArg: params.prefixArg,\n    presetFromOption: params.normalizedOptions.presetFromOption,\n    authorFromOption: params.normalizedOptions.authorFromOption,\n  });\n  assertExistingSettingsUpdateAllowed(params.settingsPath, pendingChanges, params.options.force === true);\n  if (\n    applyExistingSettingsUpdates({\n      settings,\n      normalizedPrefix: params.normalizedPrefix,\n      prefixArg: params.prefixArg,\n      presetFromOption: params.normalizedOptions.presetFromOption,\n      authorFromOption: params.normalizedOptions.authorFromOption,\n      warnings: params.warnings,\n    })\n  ) {\n    await writeSettings(params.pmRoot, settings);\n  }\n  return {\n    settings,\n    normalizedPrefix: params.normalizedPrefix,\n    chosenPreset: params.normalizedOptions.presetFromOption,\n    wizardUsed: false,\n  };\n}\n\nasync function createNewInitSettings(params: {\n  pmRoot: string;\n  normalizedPrefix: string;\n  normalizedOptions: InitNormalizedOptions;\n}): Promise<InitSettingsResolution> {\n  let normalizedPrefix = params.normalizedPrefix;\n  let chosenPreset = params.normalizedOptions.presetFromOption;\n  let chosenTelemetryEnabled: boolean | undefined;\n  let wizardUsed = false;\n  if (\n    params.normalizedOptions.presetFromOption === undefined &&\n    !params.normalizedOptions.useDefaults &&\n    process.stdin.isTTY === true &&\n    process.stdout.isTTY === true\n  ) {\n    const wizardChoices = await runInitWizard(normalizedPrefix, SETTINGS_DEFAULTS.telemetry.enabled);\n    normalizedPrefix = wizardChoices.prefix;\n    chosenPreset = wizardChoices.preset;\n    chosenTelemetryEnabled = wizardChoices.telemetry_enabled;\n    wizardUsed = true;\n  }\n  const effectivePreset = chosenPreset ?? \"minimal\";\n  const settings = cloneDefaults();\n  settings.id_prefix = normalizedPrefix;\n  applyGovernancePreset(settings, effectivePreset);\n  if (params.normalizedOptions.authorFromOption !== undefined) {\n    settings.author_default = params.normalizedOptions.authorFromOption;\n  }\n  if (chosenTelemetryEnabled !== undefined) {\n    settings.telemetry.enabled = chosenTelemetryEnabled;\n    settings.telemetry.first_run_prompt_completed = true;\n  }\n  await writeSettings(params.pmRoot, settings);\n  return {\n    settings,\n    normalizedPrefix,\n    chosenPreset,\n    wizardUsed,\n  };\n}\n\nasync function resolveInitSettings(params: {\n  pmRoot: string;\n  settingsPath: string;\n  settingsExists: boolean;\n  normalizedPrefix: string;\n  prefixArg: string | undefined;\n  options: InitCommandOptions;\n  normalizedOptions: InitNormalizedOptions;\n  warnings: string[];\n}): Promise<InitSettingsResolution> {\n  if (params.settingsExists) {\n    return await loadExistingInitSettings(params);\n  }\n  return await createNewInitSettings({\n    pmRoot: params.pmRoot,\n    normalizedPrefix: params.normalizedPrefix,\n    normalizedOptions: params.normalizedOptions,\n  });\n}\n\nasync function applyInitAgentGuidance(params: {\n  pmRoot: string;\n  cwd: string;\n  agentGuidanceMode: InitAgentGuidanceMode;\n  settings: PmSettings;\n  warnings: string[];\n}): Promise<InitAgentGuidanceResult> {\n  const agentGuidanceResult = await runInitAgentGuidance({\n    pm_root: params.pmRoot,\n    cwd: params.cwd,\n    mode: params.agentGuidanceMode,\n    interactive: process.stdin.isTTY === true && process.stdout.isTTY === true,\n    settings: params.settings,\n  });\n  params.warnings.push(...agentGuidanceResult.warnings);\n  if (agentGuidanceResult.settings_changed) {\n    await writeSettings(params.pmRoot, params.settings);\n  }\n  return {\n    ...agentGuidanceResult.summary,\n    next_steps: agentGuidanceResult.next_steps,\n  };\n}\n\nasync function ensureInitRuntimeSchemaFiles(\n  pmRoot: string,\n  settings: PmSettings,\n): Promise<{\n  createdDirs: string[];\n  warnings: string[];\n}> {\n  const createdDirs: string[] = [];\n  const warnings: string[] = [];\n  const runtimeSchemaScaffold = await ensureRuntimeSchemaFileScaffold(pmRoot, settings.schema);\n  for (const createdPath of runtimeSchemaScaffold.created_paths) {\n    createdDirs.push(createdPath);\n    warnings.push(\n      ...(await runActiveOnWriteHooks({\n        path: createdPath,\n        scope: \"project\",\n        op: \"init:runtime_schema_file\",\n      })),\n    );\n  }\n  return { createdDirs, warnings };\n}\n\nasync function maybeRegisterInitTypePreset(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  typePreset: InitTypePresetName | undefined;\n  warnings: string[];\n}): Promise<InitRegisteredTypePresetSummary | undefined> {\n  if (params.typePreset === undefined) {\n    return undefined;\n  }\n  const registeredTypePreset = await registerInitTypePreset(params.pmRoot, params.settings, params.typePreset);\n  params.warnings.push(`registered_type_preset:${params.typePreset}`);\n  params.warnings.push(\n    ...(await runActiveOnWriteHooks({\n      path: registeredTypePreset.file,\n      scope: \"project\",\n      op: \"init:type_preset\",\n    })),\n  );\n  return registeredTypePreset;\n}\n\nasync function ensureInitTypeDirectories(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  createdDirs: string[];\n  warnings: string[];\n}): Promise<void> {\n  const typeRegistry = resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations());\n  const customTypeFolders = typeRegistry.folders.filter((folder) => !(PM_REQUIRED_SUBDIRS as readonly string[]).includes(folder));\n  const scaffold = await ensureInitDirectories(params.pmRoot, customTypeFolders);\n  params.createdDirs.push(...scaffold.createdDirs);\n  params.warnings.push(...scaffold.warnings);\n}\n\nasync function maybeInstallInitBundledPackages(\n  installBundledPackages: boolean,\n  global: GlobalOptions,\n  warnings: string[],\n): Promise<InitInstalledPackagesSummary | undefined> {\n  if (!installBundledPackages) {\n    return undefined;\n  }\n  const packageInstallResult = await runExtension(\"all\", { install: true, project: true }, global);\n  warnings.push(...packageInstallResult.warnings);\n  const installedPackages = summarizeInstalledPackages(packageInstallResult);\n  if (!installedPackages.installed_all || installedPackages.packages.some((entry) => !entry.ok)) {\n    throw new PmCliError(\"pm init --with-packages did not install all bundled packages successfully.\", EXIT_CODE.GENERIC_FAILURE);\n  }\n  return installedPackages;\n}\n\nfunction buildInitNextSteps(params: {\n  installBundledPackages: boolean;\n  registeredTypePreset: InitRegisteredTypePresetSummary | undefined;\n  agentGuidanceNextSteps: string[];\n}): string[] {\n  const nextSteps: string[] = [\n    'Create your first item: pm create --type Task --title \"<title>\"',\n    'List active items: pm list',\n    'Get agent-friendly project context: pm context',\n  ];\n  if (!params.installBundledPackages) {\n    nextSteps.push(\n      \"Add optional packages for richer workflows: pm install calendar --project, pm install templates --project, pm install guide-shell --project\",\n    );\n    nextSteps.push(\"Or install everything bundled: pm init --with-packages (idempotent on re-run)\");\n  } else {\n    nextSteps.push(\"Explore newly-available commands: pm cal, pm templates, pm guide\");\n  }\n  if (params.registeredTypePreset) {\n    nextSteps.push(`Inspect registered preset types: pm schema list, pm schema show ${params.registeredTypePreset.registered[0] ?? params.registeredTypePreset.updated[0]}`);\n  }\n  nextSteps.push(\"Set PM_AUTHOR=<your-agent-id> so mutations attribute to the right caller.\");\n  for (const guidanceNextStep of params.agentGuidanceNextSteps) {\n    if (!nextSteps.includes(guidanceNextStep)) {\n      nextSteps.push(guidanceNextStep);\n    }\n  }\n  return nextSteps;\n}\n\n/**\n * Implements run init for the public runtime surface of this module.\n */\nexport async function runInit(\n  prefixArg: string | undefined,\n  global: GlobalOptions,\n  options: InitCommandOptions = {},\n): Promise<InitResult> {\n  const cwd = process.cwd();\n  const invocation = resolveInitInvocation(cwd, global, prefixArg);\n  const pmRoot = invocation.pmRoot;\n  prefixArg = invocation.prefixArg;\n  await assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot, global, options.force === true);\n  const createdDirs: string[] = [];\n  const warnings: string[] = [];\n  const baseDirs = await ensureInitDirectories(pmRoot, PM_REQUIRED_SUBDIRS);\n  createdDirs.push(...baseDirs.createdDirs);\n  warnings.push(...baseDirs.warnings);\n\n  const settingsPath = path.join(pmRoot, \"settings.json\");\n  const settingsExists = await pathExists(settingsPath);\n  const normalizedOptions = normalizeInitCommandOptions(options);\n  const settingsResolution = await resolveInitSettings({\n    pmRoot,\n    settingsPath,\n    settingsExists,\n    normalizedPrefix: normalizePrefix(prefixArg),\n    prefixArg,\n    options,\n    normalizedOptions,\n    warnings,\n  });\n  let { settings } = settingsResolution;\n\n  const agentGuidance = await applyInitAgentGuidance({\n    pmRoot,\n    cwd,\n    agentGuidanceMode: normalizedOptions.agentGuidanceMode,\n    settings,\n    warnings,\n  });\n\n  const schemaFiles = await ensureInitRuntimeSchemaFiles(pmRoot, settings);\n  createdDirs.push(...schemaFiles.createdDirs);\n  warnings.push(...schemaFiles.warnings);\n\n  const registeredTypePreset = await maybeRegisterInitTypePreset({\n    pmRoot,\n    settings,\n    typePreset: normalizedOptions.typePreset,\n    warnings,\n  });\n  if (registeredTypePreset) {\n    settings = await readSettings(pmRoot);\n  }\n\n  await ensureInitTypeDirectories({ pmRoot, settings, createdDirs, warnings });\n  const installedPackages = await maybeInstallInitBundledPackages(normalizedOptions.installBundledPackages, global, warnings);\n\n  const nextSteps = buildInitNextSteps({\n    installBundledPackages: normalizedOptions.installBundledPackages,\n    registeredTypePreset,\n    agentGuidanceNextSteps: agentGuidance.next_steps,\n  });\n\n  return {\n    ok: true,\n    path: pmRoot,\n    settings,\n    created_dirs: createdDirs,\n    warnings,\n    governance_preset: settings.governance.preset,\n    wizard_used: settingsResolution.wizardUsed,\n    ...(registeredTypePreset ? { registered_type_preset: registeredTypePreset } : {}),\n    ...(installedPackages ? { installed_packages: installedPackages } : {}),\n    next_steps: nextSteps,\n    agent_guidance: agentGuidance,\n  };\n}\n", "/**\n * @module cli/commands/init-agent-guidance\n *\n * Implements the pm init agent guidance command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport readline from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\nimport { runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport type { PmSettings } from \"../../types/index.js\";\n\n/**\n * Restricts init agent guidance mode values accepted by command, SDK, and storage contracts.\n */\nexport type InitAgentGuidanceMode = \"ask\" | \"add\" | \"skip\" | \"status\";\n\nexport const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[] = [\"ask\", \"add\", \"skip\", \"status\"];\n\nconst AGENT_GUIDANCE_TARGET_FILENAMES = [\"AGENTS.md\", \"CLAUDE.md\"] as const;\nconst AGENT_GUIDANCE_REQUIRED_TOKENS = [\n  \"pm init\",\n  \"pm context\",\n  \"pm search\",\n  \"pm create\",\n  \"pm claim\",\n  \"pm files\",\n  \"pm docs\",\n  \"pm test --run\",\n  \"pm close\",\n  \"pm release\",\n  \"pm_author\",\n] as const;\nconst AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD = 8;\nconst AGENT_GUIDANCE_TEMPLATE_VERSION = 1;\nconst AGENT_GUIDANCE_START_MARKER_PREFIX = \"<!-- pm-cli:agent-guidance:start:\";\nconst AGENT_GUIDANCE_START_MARKER = `<!-- pm-cli:agent-guidance:start:v${AGENT_GUIDANCE_TEMPLATE_VERSION} -->`;\nconst AGENT_GUIDANCE_END_MARKER = \"<!-- pm-cli:agent-guidance:end -->\";\nconst AGENT_GUIDANCE_ADD_LATER_HINT = \"Add workflow guidance later: pm init --agent-guidance add\";\n\nexport const _testOnly = {\n  toPortableRelativePath,\n  ensureTrailingNewline,\n  detectLineEnding,\n  findGuidanceBlockRange,\n  buildAgentGuidanceBlock,\n  upsertAgentGuidanceBlock,\n  resolveProjectRoot,\n  resolveTargetGuidancePath,\n  parsePromptChoice,\n  pushUnique,\n  promptForGuidanceWrite,\n  normalizeAgentGuidanceState,\n  applyAgentGuidanceState,\n  writeGuidanceFile,\n  setAgentGuidanceReadlineFactoryForTests,\n};\n\ntype AgentGuidanceReadlineInterface = ReturnType<typeof readline.createInterface>;\nlet createAgentGuidanceReadlineInterface = (): AgentGuidanceReadlineInterface => readline.createInterface({ input, output });\n\nfunction setAgentGuidanceReadlineFactoryForTests(factory: (() => AgentGuidanceReadlineInterface) | undefined): void {\n  createAgentGuidanceReadlineInterface = factory ?? (() => readline.createInterface({ input, output }));\n}\n\ninterface AgentGuidanceFileScan {\n  file_path: string;\n  exists: boolean;\n  has_guidance: boolean;\n  has_marker: boolean;\n}\n\ninterface AgentGuidanceBlockRange {\n  start_index: number;\n  end_index: number;\n}\n\n/**\n * Documents the init agent guidance summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface InitAgentGuidanceSummary {\n  mode: InitAgentGuidanceMode;\n  present: boolean;\n  prompted: boolean;\n  applied: boolean;\n  skipped: boolean;\n  declined: boolean;\n  prompt_completed: boolean;\n  template_version: number;\n  target_file: string;\n  checked_files: string[];\n  files_with_guidance: string[];\n  missing_files: string[];\n}\n\n/**\n * Documents the run init agent guidance options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RunInitAgentGuidanceOptions {\n  pm_root: string;\n  cwd: string;\n  mode: InitAgentGuidanceMode;\n  interactive: boolean;\n  settings: PmSettings;\n}\n\n/**\n * Documents the run init agent guidance result payload exchanged by command, SDK, and package integrations.\n */\nexport interface RunInitAgentGuidanceResult {\n  summary: InitAgentGuidanceSummary;\n  warnings: string[];\n  next_steps: string[];\n  settings_changed: boolean;\n}\n\nfunction toPortableRelativePath(projectRoot: string, targetPath: string): string {\n  const relative = path.relative(projectRoot, targetPath);\n  if (relative.length === 0) {\n    return path.basename(targetPath);\n  }\n  return relative.split(path.sep).join(\"/\");\n}\n\nfunction ensureTrailingNewline(value: string): string {\n  return value.endsWith(\"\\n\") ? value : `${value}\\n`;\n}\n\nfunction detectLineEnding(value: string): \"\\n\" | \"\\r\\n\" {\n  return value.includes(\"\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n}\n\nfunction findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null {\n  const startIndex = content.indexOf(AGENT_GUIDANCE_START_MARKER_PREFIX);\n  if (startIndex === -1) {\n    return null;\n  }\n  const endMarkerIndex = content.indexOf(AGENT_GUIDANCE_END_MARKER, startIndex);\n  if (endMarkerIndex === -1) {\n    return null;\n  }\n  return {\n    start_index: startIndex,\n    end_index: endMarkerIndex + AGENT_GUIDANCE_END_MARKER.length,\n  };\n}\n\nfunction hasGuidanceMarker(content: string): boolean {\n  return findGuidanceBlockRange(content) !== null;\n}\n\nfunction buildAgentGuidanceBlock(lineEnding: \"\\n\" | \"\\r\\n\"): string {\n  const lines = [\n    AGENT_GUIDANCE_START_MARKER,\n    \"## pm Workflow (Agent Quickstart)\",\n    \"\",\n    \"- Orient before mutate: `pm context --limit 10`, `pm search \\\"<keywords>\\\" --limit 10`, `pm list-open --limit 20`.\",\n    \"- Claim and execute: `pm claim <id>` then `pm update <id> --status in_progress`.\",\n    \"- Link evidence while coding: `pm files <id> --add ...`, `pm docs <id> --add ...`, `pm test <id> --add command=\\\"node scripts/run-tests.mjs test -- ...\\\"`.\",\n    \"- Verify and close: `pm test <id> --run --progress`, `pm close <id> \\\"<evidence>\\\" --validate-close warn`, `pm release <id>`.\",\n    \"- Set `PM_AUTHOR=<stable-agent-id>` before mutation commands.\",\n    \"\",\n    AGENT_GUIDANCE_END_MARKER,\n    \"\",\n  ];\n  return lines.join(lineEnding);\n}\n\nfunction upsertAgentGuidanceBlock(existingContent: string): { next_content: string; changed: boolean } {\n  const lineEnding = detectLineEnding(existingContent);\n  const nextBlock = buildAgentGuidanceBlock(lineEnding);\n  const existingRange = findGuidanceBlockRange(existingContent);\n  if (existingRange) {\n    const trailingContent = existingContent.slice(existingRange.end_index);\n    const normalizedTrailingContent = trailingContent.startsWith(\"\\r\\n\")\n      ? trailingContent.slice(2)\n      : trailingContent.startsWith(\"\\n\")\n        ? trailingContent.slice(1)\n        : trailingContent;\n    const nextContent = ensureTrailingNewline(\n      `${existingContent.slice(0, existingRange.start_index)}${nextBlock}${normalizedTrailingContent}`,\n    );\n    return {\n      next_content: nextContent,\n      changed: nextContent !== existingContent,\n    };\n  }\n  const separator = existingContent.length === 0 ? \"\" : existingContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n  const nextContent = ensureTrailingNewline(`${existingContent}${separator}${nextBlock}`);\n  return {\n    next_content: nextContent,\n    changed: nextContent !== existingContent,\n  };\n}\n\nfunction resolveProjectRoot(pmRoot: string, cwd: string): string {\n  const parent = path.dirname(pmRoot);\n  if (path.basename(pmRoot) === \"pm\" && path.basename(parent) === \".agents\") {\n    return path.dirname(parent);\n  }\n  return path.resolve(cwd, pmRoot);\n}\n\nfunction resolveTargetGuidancePath(scans: AgentGuidanceFileScan[], projectRoot: string): string {\n  const existingAgents = scans.find((entry) => path.basename(entry.file_path) === \"AGENTS.md\" && entry.exists);\n  if (existingAgents) {\n    return existingAgents.file_path;\n  }\n  const existingAny = scans.find((entry) => entry.exists);\n  if (existingAny) {\n    return existingAny.file_path;\n  }\n  return path.join(projectRoot, \"AGENTS.md\");\n}\n\nfunction parsePromptChoice(answer: string, currentDefault: boolean): boolean {\n  const normalized = answer.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return currentDefault;\n  }\n  if (normalized === \"y\" || normalized === \"yes\") {\n    return true;\n  }\n  if (normalized === \"n\" || normalized === \"no\") {\n    return false;\n  }\n  return currentDefault;\n}\n\nasync function promptForGuidanceWrite(targetRelativePath: string): Promise<boolean> {\n  const rl = createAgentGuidanceReadlineInterface();\n  try {\n    output.write(\"\\nAgent guidance check\\n\");\n    output.write(\"No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.\\n\");\n    const answer = await rl.question(`Add a compact pm workflow section to ${targetRelativePath}? [Y/n] `);\n    output.write(\"\\n\");\n    return parsePromptChoice(answer, true);\n  } finally {\n    rl.close();\n  }\n}\n\nfunction normalizeAgentGuidanceState(settings: PmSettings): PmSettings[\"agent_guidance\"] {\n  const current = settings.agent_guidance;\n  return {\n    prompt_completed: current?.prompt_completed === true,\n    declined: current?.declined === true,\n    declined_at: typeof current?.declined_at === \"string\" ? current.declined_at : \"\",\n    template_version:\n      typeof current?.template_version === \"number\" && Number.isInteger(current.template_version) && current.template_version > 0\n        ? current.template_version\n        : AGENT_GUIDANCE_TEMPLATE_VERSION,\n    last_checked_files: Array.isArray(current?.last_checked_files)\n      ? [...new Set(current.last_checked_files.map((value) => value.trim()).filter((value) => value.length > 0))].sort(\n          (left, right) => left.localeCompare(right),\n        )\n      : [],\n  };\n}\n\nasync function scanGuidanceFiles(projectRoot: string): Promise<AgentGuidanceFileScan[]> {\n  const scans: AgentGuidanceFileScan[] = [];\n  for (const filename of AGENT_GUIDANCE_TARGET_FILENAMES) {\n    const filePath = path.join(projectRoot, filename);\n    const exists = await pathExists(filePath);\n    if (!exists) {\n      scans.push({\n        file_path: filePath,\n        exists,\n        has_guidance: false,\n        has_marker: false,\n      });\n      continue;\n    }\n    const content = await fs.readFile(filePath, \"utf8\");\n    const contentLower = content.toLowerCase();\n    const tokenHits = AGENT_GUIDANCE_REQUIRED_TOKENS.filter((token) => contentLower.includes(token));\n    const hasMarker = hasGuidanceMarker(content);\n    scans.push({\n      file_path: filePath,\n      exists,\n      has_guidance: hasMarker || tokenHits.length >= AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD,\n      has_marker: hasMarker,\n    });\n  }\n  return scans;\n}\n\nfunction pushUnique(target: string[], value: string): void {\n  if (!target.includes(value)) {\n    target.push(value);\n  }\n}\n\nfunction applyAgentGuidanceState(\n  settings: PmSettings,\n  currentState: PmSettings[\"agent_guidance\"],\n): { changed: boolean; state: PmSettings[\"agent_guidance\"] } {\n  const existing = normalizeAgentGuidanceState(settings);\n  const changed = JSON.stringify(existing) !== JSON.stringify(currentState);\n  if (changed) {\n    settings.agent_guidance = currentState;\n  }\n  return { changed, state: currentState };\n}\n\nasync function writeGuidanceFile(filePath: string): Promise<{ changed: boolean; warnings: string[] }> {\n  const exists = await pathExists(filePath);\n  const currentContent = exists ? await fs.readFile(filePath, \"utf8\") : \"\";\n  const nextContent = upsertAgentGuidanceBlock(currentContent);\n  if (!nextContent.changed) {\n    return { changed: false, warnings: [] };\n  }\n  await fs.writeFile(filePath, nextContent.next_content, \"utf8\");\n  return {\n    changed: true,\n    warnings: await runActiveOnWriteHooks({\n      path: filePath,\n      scope: \"project\",\n      op: \"init:agent_guidance_file\",\n    }),\n  };\n}\n\nfunction buildInitAgentGuidanceSummary(params: {\n  mode: InitAgentGuidanceMode;\n  scans: AgentGuidanceFileScan[];\n  projectRoot: string;\n  targetRelativePath: string;\n  prompted: boolean;\n  applied: boolean;\n  skipped: boolean;\n  state: PmSettings[\"agent_guidance\"];\n}): InitAgentGuidanceSummary {\n  return {\n    mode: params.mode,\n    present: params.scans.some((entry) => entry.has_guidance),\n    prompted: params.prompted,\n    applied: params.applied,\n    skipped: params.skipped,\n    declined: params.state.declined,\n    prompt_completed: params.state.prompt_completed,\n    template_version: params.state.template_version,\n    target_file: params.targetRelativePath,\n    checked_files: params.scans.map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),\n    files_with_guidance: params.scans\n      .filter((entry) => entry.has_guidance)\n      .map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),\n    missing_files: params.scans\n      .filter((entry) => !entry.exists)\n      .map((entry) => toPortableRelativePath(params.projectRoot, entry.file_path)),\n  };\n}\n\nasync function refreshGuidanceScansAfterApply(\n  applied: boolean,\n  scans: AgentGuidanceFileScan[],\n  projectRoot: string,\n): Promise<AgentGuidanceFileScan[]> {\n  return applied ? await scanGuidanceFiles(projectRoot) : scans;\n}\n\ninterface InitAgentGuidanceFlowState {\n  warnings: string[];\n  nextSteps: string[];\n  prompted: boolean;\n  applied: boolean;\n  skipped: boolean;\n  state: PmSettings[\"agent_guidance\"];\n}\n\ninterface InitAgentGuidanceModeContext {\n  mode: InitAgentGuidanceMode;\n  interactive: boolean;\n  targetPath: string;\n  targetRelativePath: string;\n  checkedFiles: string[];\n  presentBefore: boolean;\n}\n\nfunction markAgentGuidanceRunState(\n  flow: InitAgentGuidanceFlowState,\n  checkedFiles: string[],\n  partial: Partial<PmSettings[\"agent_guidance\"]>,\n): void {\n  flow.state = {\n    ...flow.state,\n    ...partial,\n    template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,\n    last_checked_files: checkedFiles,\n  };\n}\n\nasync function addAgentGuidanceBlockIfMissing(\n  flow: InitAgentGuidanceFlowState,\n  context: Pick<InitAgentGuidanceModeContext, \"presentBefore\" | \"targetPath\" | \"targetRelativePath\">,\n): Promise<void> {\n  if (context.presentBefore) {\n    return;\n  }\n  const writeResult = await writeGuidanceFile(context.targetPath);\n  flow.warnings.push(...writeResult.warnings);\n  if (writeResult.changed) {\n    flow.applied = true;\n    flow.warnings.push(`agent_guidance:added:${context.targetRelativePath}`);\n  }\n}\n\nfunction handleAgentGuidanceStatusMode(flow: InitAgentGuidanceFlowState, presentBefore: boolean): void {\n  if (!presentBefore) {\n    flow.warnings.push(\"agent_guidance:missing\");\n    pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);\n  }\n}\n\nfunction handleAgentGuidanceSkipMode(flow: InitAgentGuidanceFlowState, checkedFiles: string[]): void {\n  flow.skipped = true;\n  markAgentGuidanceRunState(flow, checkedFiles, {\n    prompt_completed: true,\n    declined: true,\n    declined_at: flow.state.declined_at || new Date().toISOString(),\n  });\n  flow.warnings.push(\"agent_guidance:explicit_skip\");\n  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);\n}\n\nasync function handleAgentGuidanceAddMode(\n  flow: InitAgentGuidanceFlowState,\n  context: InitAgentGuidanceModeContext,\n): Promise<void> {\n  await addAgentGuidanceBlockIfMissing(flow, context);\n  markAgentGuidanceRunState(flow, context.checkedFiles, {\n    prompt_completed: true,\n    declined: false,\n    declined_at: \"\",\n  });\n}\n\nfunction handlePresentAgentGuidance(flow: InitAgentGuidanceFlowState, checkedFiles: string[]): void {\n  if (flow.state.declined) {\n    markAgentGuidanceRunState(flow, checkedFiles, {\n      prompt_completed: true,\n      declined: false,\n      declined_at: \"\",\n    });\n  }\n}\n\nfunction handleDeclinedAgentGuidance(flow: InitAgentGuidanceFlowState): void {\n  flow.skipped = true;\n  flow.warnings.push(\"agent_guidance:skipped_declined\");\n  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);\n}\n\nasync function handleInteractiveAgentGuidancePrompt(\n  flow: InitAgentGuidanceFlowState,\n  context: InitAgentGuidanceModeContext,\n): Promise<void> {\n  flow.prompted = true;\n  const approved = await promptForGuidanceWrite(context.targetRelativePath);\n  if (approved) {\n    await addAgentGuidanceBlockIfMissing(flow, context);\n    markAgentGuidanceRunState(flow, context.checkedFiles, {\n      prompt_completed: true,\n      declined: false,\n      declined_at: \"\",\n    });\n    return;\n  }\n  flow.skipped = true;\n  markAgentGuidanceRunState(flow, context.checkedFiles, {\n    prompt_completed: true,\n    declined: true,\n    declined_at: new Date().toISOString(),\n  });\n  flow.warnings.push(\"agent_guidance:declined\");\n  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);\n}\n\nfunction handleNonInteractiveMissingAgentGuidance(flow: InitAgentGuidanceFlowState): void {\n  flow.warnings.push(\"agent_guidance:missing_non_interactive\");\n  pushUnique(flow.nextSteps, AGENT_GUIDANCE_ADD_LATER_HINT);\n}\n\nasync function applyAgentGuidanceMode(\n  initialState: PmSettings[\"agent_guidance\"],\n  context: InitAgentGuidanceModeContext,\n): Promise<InitAgentGuidanceFlowState> {\n  const flow: InitAgentGuidanceFlowState = {\n    warnings: [],\n    nextSteps: [],\n    prompted: false,\n    applied: false,\n    skipped: false,\n    state: initialState,\n  };\n\n  if (context.mode === \"status\") {\n    handleAgentGuidanceStatusMode(flow, context.presentBefore);\n    return flow;\n  }\n  if (context.mode === \"skip\") {\n    handleAgentGuidanceSkipMode(flow, context.checkedFiles);\n    return flow;\n  }\n  if (context.mode === \"add\") {\n    await handleAgentGuidanceAddMode(flow, context);\n    return flow;\n  }\n  if (context.presentBefore) {\n    handlePresentAgentGuidance(flow, context.checkedFiles);\n    return flow;\n  }\n  if (flow.state.prompt_completed && flow.state.declined) {\n    handleDeclinedAgentGuidance(flow);\n    return flow;\n  }\n  if (context.interactive) {\n    await handleInteractiveAgentGuidancePrompt(flow, context);\n    return flow;\n  }\n  handleNonInteractiveMissingAgentGuidance(flow);\n  return flow;\n}\n\n/**\n * Implements run init agent guidance for the public runtime surface of this module.\n */\nexport async function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult> {\n  const projectRoot = resolveProjectRoot(options.pm_root, options.cwd);\n  let scans = await scanGuidanceFiles(projectRoot);\n  const targetPath = resolveTargetGuidancePath(scans, projectRoot);\n  const targetRelativePath = toPortableRelativePath(projectRoot, targetPath);\n  const checkedFiles = scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path));\n  const presentBefore = scans.some((entry) => entry.has_guidance);\n  const flow = await applyAgentGuidanceMode(normalizeAgentGuidanceState(options.settings), {\n    mode: options.mode,\n    interactive: options.interactive,\n    targetPath,\n    targetRelativePath,\n    checkedFiles,\n    presentBefore,\n  });\n\n  const stateUpdate = applyAgentGuidanceState(options.settings, flow.state);\n  scans = await refreshGuidanceScansAfterApply(flow.applied, scans, projectRoot);\n\n  const summary = buildInitAgentGuidanceSummary({\n    mode: options.mode,\n    scans,\n    projectRoot,\n    targetRelativePath,\n    prompted: flow.prompted,\n    applied: flow.applied,\n    skipped: flow.skipped,\n    state: flow.state,\n  });\n\n  return {\n    summary,\n    warnings: flow.warnings,\n    next_steps: flow.nextSteps,\n    settings_changed: stateUpdate.changed,\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["fs", "path", "readline", "input", "output", "nextContent", "readline", "input", "output", "path", "global", "fs"]
+}

package/dist/cli-bundle/chunks/{chunk-BI4R7HI2.js → chunk-JZJJEJBR.js}

@@ -1,18 +1,18 @@
 import {
   readHistoryEntries
-} from "./chunk-Z5F6XZXE.js";
+} from "./chunk-EB4BBEZD.js";
 import {
   parseLimit
-} from "./chunk-4PFVUUYV.js";
+} from "./chunk-3MLQZI3H.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-MZG6I2Q2.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -23,7 +23,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -213,4 +213,4 @@ export {
   _testOnly,
   runActivity
 };
-//# sourceMappingURL=chunk-BI4R7HI2.js.map
+//# sourceMappingURL=chunk-JZJJEJBR.js.map

package/dist/cli-bundle/chunks/{chunk-XRYSCRZR.js → chunk-KKHIQOTN.js}

@@ -1,10 +1,10 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   nowIso
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-MZG6I2Q2.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -20,7 +20,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/search/http-client.js
 !(function() {
@@ -2036,4 +2036,4 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-XRYSCRZR.js.map
+//# sourceMappingURL=chunk-KKHIQOTN.js.map

package/dist/cli-bundle/chunks/{chunk-572FKBRL.js → chunk-LLQLLAKU.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]="8006b49d-650e-5e01-b633-dd123c57b2d8")}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]="4864c4b3-8a15-5324-8332-42e51eb9a217")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -11,7 +11,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-L4SLHV6G.js";
+} from "./chunk-SL2ANJSV.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
@@ -910,8 +910,10 @@ var GOVERNANCE_AND_CONTENT_FILTER_FLAG_CONTRACTS = [
   { flag: "--no-learnings" },
   { flag: "--has-files" },
   { flag: "--no-files" },
+  { flag: "--filter-files-missing" },
   { flag: "--has-docs" },
   { flag: "--no-docs" },
+  { flag: "--filter-docs-missing" },
   { flag: "--has-tests" },
   { flag: "--no-tests" },
   { flag: "--has-comments" },
@@ -2275,8 +2277,10 @@ var TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS = [
   { param: "noLearnings", flag: "--no-learnings" },
   { param: "hasFiles", flag: "--has-files" },
   { param: "noFiles", flag: "--no-files" },
+  { param: "filterFilesMissing", flag: "--filter-files-missing" },
   { param: "hasDocs", flag: "--has-docs" },
   { param: "noDocs", flag: "--no-docs" },
+  { param: "filterDocsMissing", flag: "--filter-docs-missing" },
   { param: "hasTests", flag: "--has-tests" },
   { param: "noTests", flag: "--no-tests" },
   { param: "hasComments", flag: "--has-comments" },
@@ -3880,104 +3884,65 @@ var NEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "format"
 ]);
 var AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
+var MANAGED_EXTENSION_PACKAGE_OPTION_KEYS = [
+  "target",
+  "scope",
+  "github",
+  "ref",
+  "init",
+  "install",
+  "uninstall",
+  "explore",
+  "manage",
+  "describe",
+  "markdown",
+  "output",
+  "reload",
+  "doctor",
+  "catalog",
+  "adopt",
+  "adoptAll",
+  "activate",
+  "deactivate",
+  "runtimeProbe",
+  "fixManagedState",
+  "detail",
+  "trace",
+  "watch",
+  "strictExit",
+  "failOnWarn"
+];
+function managedLifecycleSchemaContracts(prefix) {
+  return {
+    [`${prefix}-init`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-install`]: {
+      optional: ["target", "github", "scope", "ref"],
+      anyOfRequired: [["target"], ["github"]]
+    },
+    [`${prefix}-uninstall`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-explore`]: { optional: ["scope"] },
+    [`${prefix}-manage`]: { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    [`${prefix}-describe`]: { optional: ["target", "scope", "markdown", "output"] },
+    [`${prefix}-reload`]: { optional: ["scope", "watch"] },
+    [`${prefix}-doctor`]: { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    [`${prefix}-catalog`]: { optional: ["scope", "fields"] },
+    [`${prefix}-adopt`]: { required: ["target"], optional: ["scope", "github", "ref"] },
+    [`${prefix}-adopt-all`]: { optional: ["scope"] },
+    [`${prefix}-activate`]: { required: ["target"], optional: ["scope"] },
+    [`${prefix}-deactivate`]: { required: ["target"], optional: ["scope"] },
+    [prefix]: {
+      optional: MANAGED_EXTENSION_PACKAGE_OPTION_KEYS
+    }
+  };
+}
 var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   init: { optional: ["prefix", "preset", "typePreset", "defaults", "author", "agentGuidance", "withPackages", "force", "verbose"] },
   config: {
     required: ["scope", "configAction"],
     optional: ["key", "value", "criterion", "clearCriteria", "format", "policy"]
   },
-  "extension-init": { required: ["target"], optional: ["scope"] },
-  "extension-install": {
-    optional: ["target", "github", "scope", "ref"],
-    anyOfRequired: [["target"], ["github"]]
-  },
-  "extension-uninstall": { required: ["target"], optional: ["scope"] },
-  "extension-explore": { optional: ["scope"] },
-  "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
-  "extension-describe": { optional: ["target", "scope", "markdown", "output"] },
-  "extension-reload": { optional: ["scope", "watch"] },
-  "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "extension-catalog": { optional: ["scope", "fields"] },
-  "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
-  "extension-adopt-all": { optional: ["scope"] },
-  "extension-activate": { required: ["target"], optional: ["scope"] },
-  "extension-deactivate": { required: ["target"], optional: ["scope"] },
-  extension: {
-    optional: [
-      "target",
-      "scope",
-      "github",
-      "ref",
-      "init",
-      "install",
-      "uninstall",
-      "explore",
-      "manage",
-      "describe",
-      "markdown",
-      "output",
-      "reload",
-      "doctor",
-      "catalog",
-      "adopt",
-      "adoptAll",
-      "activate",
-      "deactivate",
-      "runtimeProbe",
-      "fixManagedState",
-      "detail",
-      "trace",
-      "watch",
-      "strictExit",
-      "failOnWarn"
-    ]
-  },
-  "package-init": { required: ["target"], optional: ["scope"] },
-  "package-install": {
-    optional: ["target", "github", "scope", "ref"],
-    anyOfRequired: [["target"], ["github"]]
-  },
-  "package-uninstall": { required: ["target"], optional: ["scope"] },
-  "package-explore": { optional: ["scope"] },
-  "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
-  "package-describe": { optional: ["target", "scope", "markdown", "output"] },
-  "package-reload": { optional: ["scope", "watch"] },
-  "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "package-catalog": { optional: ["scope", "fields"] },
-  "package-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
-  "package-adopt-all": { optional: ["scope"] },
-  "package-activate": { required: ["target"], optional: ["scope"] },
-  "package-deactivate": { required: ["target"], optional: ["scope"] },
-  package: {
-    optional: [
-      "target",
-      "scope",
-      "github",
-      "ref",
-      "init",
-      "install",
-      "uninstall",
-      "explore",
-      "manage",
-      "describe",
-      "markdown",
-      "output",
-      "reload",
-      "doctor",
-      "catalog",
-      "adopt",
-      "adoptAll",
-      "activate",
-      "deactivate",
-      "runtimeProbe",
-      "fixManagedState",
-      "detail",
-      "trace",
-      "watch",
-      "strictExit",
-      "failOnWarn"
-    ]
-  },
+  ...managedLifecycleSchemaContracts("extension"),
+  ...managedLifecycleSchemaContracts("package"),
   install: {
     optional: ["target", "github", "scope", "ref"],
     anyOfRequired: [["target"], ["github"]]
@@ -4658,6 +4623,6 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-572FKBRL.js.map
+//# sourceMappingURL=chunk-LLQLLAKU.js.map
 
-//# debugId=8006b49d-650e-5e01-b633-dd123c57b2d8
+//# debugId=4864c4b3-8a15-5324-8332-42e51eb9a217