@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/cli/extension-command-options.js

@@ -1,3 +1,7 @@
+
+!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]="d166f748-b8c5-5837-a22e-8a0e34b28c72")}catch(e){}}();
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
 const UNSAFE_LOOSE_OPTION_KEYS = new Set(["__proto__", "prototype", "constructor"]);
 function toLooseOptionKey(rawKey) {
     const key = rawKey.trim().toLowerCase();
@@ -18,9 +22,33 @@ function setLooseOptionValue(options, key, value) {
 }
 function parseLooseOptionToken(args, index) {
     const token = args[index];
-    if (!token.startsWith("--") || token === "--") {
+    if (!token.startsWith("-") || token === "-" || token === "--") {
         return null;
     }
+    if (!token.startsWith("--")) {
+        const equalsIndex = token.indexOf("=");
+        if (equalsIndex >= 0) {
+            return {
+                consumed: 1,
+                key: token.slice(1, equalsIndex).trim(),
+                value: token.slice(equalsIndex + 1),
+            };
+        }
+        const key = token.slice(1).trim();
+        const next = args[index + 1];
+        if (typeof next === "string" && !next.startsWith("-")) {
+            return {
+                consumed: 2,
+                key,
+                value: next,
+            };
+        }
+        return {
+            consumed: 1,
+            key,
+            value: true,
+        };
+    }
     const equalsIndex = token.indexOf("=");
     if (equalsIndex >= 0) {
         return {
@@ -87,6 +115,67 @@ function collectLooseOptionKeys(definition) {
     }
     return [...new Set(keys)];
 }
+function resolveCanonicalLooseOptionKey(definition) {
+    const long = typeof definition.long === "string" ? definition.long.trim() : "";
+    if (long.startsWith("--")) {
+        const normalized = toLooseOptionKey(long.slice(2));
+        if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {
+            return normalized;
+        }
+    }
+    return collectLooseOptionKeys(definition)[0] ?? null;
+}
+function formatLooseOptionLabel(definition) {
+    const long = typeof definition.long === "string" ? definition.long.trim() : "";
+    if (long.startsWith("--") && long.length > 2) {
+        return long;
+    }
+    const short = typeof definition.short === "string" ? definition.short.trim() : "";
+    if (short.startsWith("-") && !short.startsWith("--") && short.length > 1) {
+        return short;
+    }
+    return null;
+}
+export function validateLooseCommandOptionsWithFlagDefinitions(options, definitions, commandPath) {
+    if (definitions.length === 0) {
+        return;
+    }
+    const allowed = new Set();
+    const disabled = new Map();
+    const required = [];
+    const labels = [];
+    for (const definition of definitions) {
+        const keys = collectLooseOptionKeys(definition);
+        const label = formatLooseOptionLabel(definition);
+        if (label) {
+            labels.push(label);
+        }
+        for (const key of keys) {
+            allowed.add(key);
+            if (definition.enabled === false) {
+                disabled.set(key, label ?? `--${key}`);
+            }
+        }
+        if (definition.required === true && definition.enabled !== false && keys.length > 0) {
+            required.push({ keys, label: label ?? `--${keys[0]}` });
+        }
+    }
+    for (const key of Object.keys(options)) {
+        if (!allowed.has(key)) {
+            const expected = labels.length > 0 ? ` Expected one of: ${[...new Set(labels)].join(", ")}.` : "";
+            throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`, EXIT_CODE.USAGE);
+        }
+        const disabledLabel = disabled.get(key);
+        if (disabledLabel) {
+            throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`, EXIT_CODE.USAGE);
+        }
+    }
+    for (const entry of required) {
+        if (!entry.keys.some((key) => Object.hasOwn(options, key))) {
+            throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`, EXIT_CODE.USAGE);
+        }
+    }
+}
 function coerceLooseOptionValue(value, kind) {
     if (Array.isArray(value)) {
         return value.map((entry) => coerceLooseOptionValue(entry, kind));
@@ -133,16 +222,28 @@ export function coerceLooseCommandOptionsWithFlagDefinitions(options, definition
         coerced[key] = value;
     }
     for (const definition of definitions) {
-        const kind = resolveLooseOptionCoercionKind(definition);
-        if (!kind) {
+        const canonical = resolveCanonicalLooseOptionKey(definition);
+        if (!canonical) {
             continue;
         }
         for (const key of collectLooseOptionKeys(definition)) {
-            if (!Object.hasOwn(coerced, key)) {
+            if (key === canonical || !Object.hasOwn(coerced, key)) {
                 continue;
             }
-            coerced[key] = coerceLooseOptionValue(coerced[key], kind);
+            if (Object.hasOwn(coerced, canonical)) {
+                continue;
+            }
+            coerced[canonical] = coerced[key];
+            delete coerced[key];
+        }
+        const kind = resolveLooseOptionCoercionKind(definition);
+        if (!kind) {
+            continue;
+        }
+        if (!Object.hasOwn(coerced, canonical)) {
+            continue;
         }
+        coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);
     }
     return coerced;
 }
@@ -165,4 +266,5 @@ export function parseLooseCommandOptions(args) {
     }
     return options;
 }
-//# sourceMappingURL=extension-command-options.js.map
+//# sourceMappingURL=extension-command-options.js.map
+//# debugId=d166f748-b8c5-5837-a22e-8a0e34b28c72

package/dist/cli/extension-command-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-command-options.js","sourceRoot":"/","sources":["cli/extension-command-options.ts"],"names":[],"mappings":"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","sourcesContent":["const UNSAFE_LOOSE_OPTION_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\nfunction toLooseOptionKey(rawKey: string): string {\n  const key = rawKey.trim().toLowerCase();\n  return key.replaceAll(/-([a-z0-9])/g, (_match, group: string) => group.toUpperCase());\n}\n\nfunction setLooseOptionValue(options: Record<string, unknown>, key: string, value: unknown): void {\n  const existing = options[key];\n  if (existing === undefined) {\n    options[key] = value;\n    return;\n  }\n  if (Array.isArray(existing)) {\n    existing.push(value);\n    options[key] = existing;\n    return;\n  }\n  options[key] = [existing, value];\n}\n\ninterface ParsedLooseOptionToken {\n  consumed: number;\n  key: string;\n  value: unknown;\n}\n\nfunction parseLooseOptionToken(args: string[], index: number): ParsedLooseOptionToken | null {\n  const token = args[index];\n  if (!token.startsWith(\"--\") || token === \"--\") {\n    return null;\n  }\n\n  const equalsIndex = token.indexOf(\"=\");\n  if (equalsIndex >= 0) {\n    return {\n      consumed: 1,\n      key: token.slice(2, equalsIndex).trim(),\n      value: token.slice(equalsIndex + 1),\n    };\n  }\n\n  if (token.startsWith(\"--no-\")) {\n    return {\n      consumed: 1,\n      key: token.slice(5).trim(),\n      value: false,\n    };\n  }\n\n  const key = token.slice(2).trim();\n  const next = args[index + 1];\n  if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n    return {\n      consumed: 2,\n      key,\n      value: next,\n    };\n  }\n  return {\n    consumed: 1,\n    key,\n    value: true,\n  };\n}\n\nfunction isUnsafeLooseOptionKey(key: string): boolean {\n  return UNSAFE_LOOSE_OPTION_KEYS.has(key);\n}\n\ntype LooseOptionCoercionKind = \"string\" | \"number\" | \"boolean\";\n\nfunction resolveLooseOptionCoercionKind(definition: Record<string, unknown>): LooseOptionCoercionKind | null {\n  const explicitType = typeof definition.type === \"string\" ? definition.type.trim().toLowerCase() : undefined;\n  const valueType = typeof definition.value_type === \"string\" ? definition.value_type.trim().toLowerCase() : undefined;\n  const kind = explicitType ?? valueType;\n  if (kind === \"string\") {\n    return \"string\";\n  }\n  if (kind === \"number\" || kind === \"int\" || kind === \"integer\" || kind === \"float\") {\n    return \"number\";\n  }\n  if (kind === \"boolean\" || kind === \"bool\") {\n    return \"boolean\";\n  }\n  return null;\n}\n\nfunction collectLooseOptionKeys(definition: Record<string, unknown>): string[] {\n  const keys: string[] = [];\n  const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n  const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n  if (long.startsWith(\"--\")) {\n    const normalized = toLooseOptionKey(long.slice(2));\n    if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n      keys.push(normalized);\n    }\n  }\n  if (short.startsWith(\"-\") && !short.startsWith(\"--\")) {\n    const normalized = toLooseOptionKey(short.slice(1));\n    if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n      keys.push(normalized);\n    }\n  }\n  return [...new Set(keys)];\n}\n\nfunction coerceLooseOptionValue(value: unknown, kind: LooseOptionCoercionKind): unknown {\n  if (Array.isArray(value)) {\n    return value.map((entry) => coerceLooseOptionValue(entry, kind));\n  }\n  if (kind === \"string\") {\n    if (typeof value === \"string\") {\n      return value;\n    }\n    if (value === null || value === undefined) {\n      return value;\n    }\n    return String(value);\n  }\n  if (kind === \"number\") {\n    if (typeof value === \"number\") {\n      return Number.isFinite(value) ? value : value;\n    }\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      const parsed = Number(value);\n      return Number.isFinite(parsed) ? parsed : value;\n    }\n    return value;\n  }\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  return value;\n}\n\nexport function coerceLooseCommandOptionsWithFlagDefinitions(\n  options: Record<string, unknown>,\n  definitions: Array<Record<string, unknown>>,\n): Record<string, unknown> {\n  if (definitions.length === 0) {\n    return options;\n  }\n  const coerced = Object.create(null) as Record<string, unknown>;\n  for (const [key, value] of Object.entries(options)) {\n    coerced[key] = value;\n  }\n  for (const definition of definitions) {\n    const kind = resolveLooseOptionCoercionKind(definition);\n    if (!kind) {\n      continue;\n    }\n    for (const key of collectLooseOptionKeys(definition)) {\n      if (!Object.hasOwn(coerced, key)) {\n        continue;\n      }\n      coerced[key] = coerceLooseOptionValue(coerced[key], kind);\n    }\n  }\n  return coerced;\n}\n\nexport function parseLooseCommandOptions(args: string[]): Record<string, unknown> {\n  const options = Object.create(null) as Record<string, unknown>;\n  let index = 0;\n  while (index < args.length) {\n    const parsed = parseLooseOptionToken(args, index);\n    if (!parsed) {\n      index += 1;\n      continue;\n    }\n\n    const normalizedKey = toLooseOptionKey(parsed.key);\n    if (normalizedKey.length === 0 || isUnsafeLooseOptionKey(normalizedKey)) {\n      index += parsed.consumed;\n      continue;\n    }\n    setLooseOptionValue(options, normalizedKey, parsed.value);\n    index += parsed.consumed;\n  }\n  return options;\n}\n"]}
+{"version":3,"file":"extension-command-options.js","sources":["cli/extension-command-options.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\n\nconst UNSAFE_LOOSE_OPTION_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\nfunction toLooseOptionKey(rawKey: string): string {\n  const key = rawKey.trim().toLowerCase();\n  return key.replaceAll(/-([a-z0-9])/g, (_match, group: string) => group.toUpperCase());\n}\n\nfunction setLooseOptionValue(options: Record<string, unknown>, key: string, value: unknown): void {\n  const existing = options[key];\n  if (existing === undefined) {\n    options[key] = value;\n    return;\n  }\n  if (Array.isArray(existing)) {\n    existing.push(value);\n    options[key] = existing;\n    return;\n  }\n  options[key] = [existing, value];\n}\n\ninterface ParsedLooseOptionToken {\n  consumed: number;\n  key: string;\n  value: unknown;\n}\n\nfunction parseLooseOptionToken(args: string[], index: number): ParsedLooseOptionToken | null {\n  const token = args[index];\n  if (!token.startsWith(\"-\") || token === \"-\" || token === \"--\") {\n    return null;\n  }\n\n  if (!token.startsWith(\"--\")) {\n    const equalsIndex = token.indexOf(\"=\");\n    if (equalsIndex >= 0) {\n      return {\n        consumed: 1,\n        key: token.slice(1, equalsIndex).trim(),\n        value: token.slice(equalsIndex + 1),\n      };\n    }\n    const key = token.slice(1).trim();\n    const next = args[index + 1];\n    if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n      return {\n        consumed: 2,\n        key,\n        value: next,\n      };\n    }\n    return {\n      consumed: 1,\n      key,\n      value: true,\n    };\n  }\n\n  const equalsIndex = token.indexOf(\"=\");\n  if (equalsIndex >= 0) {\n    return {\n      consumed: 1,\n      key: token.slice(2, equalsIndex).trim(),\n      value: token.slice(equalsIndex + 1),\n    };\n  }\n\n  if (token.startsWith(\"--no-\")) {\n    return {\n      consumed: 1,\n      key: token.slice(5).trim(),\n      value: false,\n    };\n  }\n\n  const key = token.slice(2).trim();\n  const next = args[index + 1];\n  if (typeof next === \"string\" && !next.startsWith(\"-\")) {\n    return {\n      consumed: 2,\n      key,\n      value: next,\n    };\n  }\n  return {\n    consumed: 1,\n    key,\n    value: true,\n  };\n}\n\nfunction isUnsafeLooseOptionKey(key: string): boolean {\n  return UNSAFE_LOOSE_OPTION_KEYS.has(key);\n}\n\ntype LooseOptionCoercionKind = \"string\" | \"number\" | \"boolean\";\n\nfunction resolveLooseOptionCoercionKind(definition: Record<string, unknown>): LooseOptionCoercionKind | null {\n  const explicitType = typeof definition.type === \"string\" ? definition.type.trim().toLowerCase() : undefined;\n  const valueType = typeof definition.value_type === \"string\" ? definition.value_type.trim().toLowerCase() : undefined;\n  const kind = explicitType ?? valueType;\n  if (kind === \"string\") {\n    return \"string\";\n  }\n  if (kind === \"number\" || kind === \"int\" || kind === \"integer\" || kind === \"float\") {\n    return \"number\";\n  }\n  if (kind === \"boolean\" || kind === \"bool\") {\n    return \"boolean\";\n  }\n  return null;\n}\n\nfunction collectLooseOptionKeys(definition: Record<string, unknown>): string[] {\n  const keys: string[] = [];\n  const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n  const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n  if (long.startsWith(\"--\")) {\n    const normalized = toLooseOptionKey(long.slice(2));\n    if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n      keys.push(normalized);\n    }\n  }\n  if (short.startsWith(\"-\") && !short.startsWith(\"--\")) {\n    const normalized = toLooseOptionKey(short.slice(1));\n    if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n      keys.push(normalized);\n    }\n  }\n  return [...new Set(keys)];\n}\n\nfunction resolveCanonicalLooseOptionKey(definition: Record<string, unknown>): string | null {\n  const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n  if (long.startsWith(\"--\")) {\n    const normalized = toLooseOptionKey(long.slice(2));\n    if (normalized.length > 0 && !isUnsafeLooseOptionKey(normalized)) {\n      return normalized;\n    }\n  }\n  return collectLooseOptionKeys(definition)[0] ?? null;\n}\n\nfunction formatLooseOptionLabel(definition: Record<string, unknown>): string | null {\n  const long = typeof definition.long === \"string\" ? definition.long.trim() : \"\";\n  if (long.startsWith(\"--\") && long.length > 2) {\n    return long;\n  }\n  const short = typeof definition.short === \"string\" ? definition.short.trim() : \"\";\n  if (short.startsWith(\"-\") && !short.startsWith(\"--\") && short.length > 1) {\n    return short;\n  }\n  return null;\n}\n\nexport function validateLooseCommandOptionsWithFlagDefinitions(\n  options: Record<string, unknown>,\n  definitions: Array<Record<string, unknown>>,\n  commandPath: string,\n): void {\n  if (definitions.length === 0) {\n    return;\n  }\n  const allowed = new Set<string>();\n  const disabled = new Map<string, string>();\n  const required: Array<{ keys: string[]; label: string }> = [];\n  const labels: string[] = [];\n  for (const definition of definitions) {\n    const keys = collectLooseOptionKeys(definition);\n    const label = formatLooseOptionLabel(definition);\n    if (label) {\n      labels.push(label);\n    }\n    for (const key of keys) {\n      allowed.add(key);\n      if (definition.enabled === false) {\n        disabled.set(key, label ?? `--${key}`);\n      }\n    }\n    if (definition.required === true && definition.enabled !== false && keys.length > 0) {\n      required.push({ keys, label: label ?? `--${keys[0]}` });\n    }\n  }\n  for (const key of Object.keys(options)) {\n    if (!allowed.has(key)) {\n      const expected = labels.length > 0 ? ` Expected one of: ${[...new Set(labels)].join(\", \")}.` : \"\";\n      throw new PmCliError(`Unknown option '--${key}' for extension command '${commandPath}'.${expected}`, EXIT_CODE.USAGE);\n    }\n    const disabledLabel = disabled.get(key);\n    if (disabledLabel) {\n      throw new PmCliError(`Option '${disabledLabel}' is disabled for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n    }\n  }\n  for (const entry of required) {\n    if (!entry.keys.some((key) => Object.hasOwn(options, key))) {\n      throw new PmCliError(`Missing required option '${entry.label}' for extension command '${commandPath}'.`, EXIT_CODE.USAGE);\n    }\n  }\n}\n\nfunction coerceLooseOptionValue(value: unknown, kind: LooseOptionCoercionKind): unknown {\n  if (Array.isArray(value)) {\n    return value.map((entry) => coerceLooseOptionValue(entry, kind));\n  }\n  if (kind === \"string\") {\n    if (typeof value === \"string\") {\n      return value;\n    }\n    if (value === null || value === undefined) {\n      return value;\n    }\n    return String(value);\n  }\n  if (kind === \"number\") {\n    if (typeof value === \"number\") {\n      return Number.isFinite(value) ? value : value;\n    }\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      const parsed = Number(value);\n      return Number.isFinite(parsed) ? parsed : value;\n    }\n    return value;\n  }\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  return value;\n}\n\nexport function coerceLooseCommandOptionsWithFlagDefinitions(\n  options: Record<string, unknown>,\n  definitions: Array<Record<string, unknown>>,\n): Record<string, unknown> {\n  if (definitions.length === 0) {\n    return options;\n  }\n  const coerced = Object.create(null) as Record<string, unknown>;\n  for (const [key, value] of Object.entries(options)) {\n    coerced[key] = value;\n  }\n  for (const definition of definitions) {\n    const canonical = resolveCanonicalLooseOptionKey(definition);\n    if (!canonical) {\n      continue;\n    }\n    for (const key of collectLooseOptionKeys(definition)) {\n      if (key === canonical || !Object.hasOwn(coerced, key)) {\n        continue;\n      }\n      if (Object.hasOwn(coerced, canonical)) {\n        continue;\n      }\n      coerced[canonical] = coerced[key];\n      delete coerced[key];\n    }\n    const kind = resolveLooseOptionCoercionKind(definition);\n    if (!kind) {\n      continue;\n    }\n    if (!Object.hasOwn(coerced, canonical)) {\n      continue;\n    }\n    coerced[canonical] = coerceLooseOptionValue(coerced[canonical], kind);\n  }\n  return coerced;\n}\n\nexport function parseLooseCommandOptions(args: string[]): Record<string, unknown> {\n  const options = Object.create(null) as Record<string, unknown>;\n  let index = 0;\n  while (index < args.length) {\n    const parsed = parseLooseOptionToken(args, index);\n    if (!parsed) {\n      index += 1;\n      continue;\n    }\n\n    const normalizedKey = toLooseOptionKey(parsed.key);\n    if (normalizedKey.length === 0 || isUnsafeLooseOptionKey(normalizedKey)) {\n      index += parsed.consumed;\n      continue;\n    }\n    setLooseOptionValue(options, normalizedKey, parsed.value);\n    index += parsed.consumed;\n  }\n  return options;\n}\n"],"names":[],"mappings":"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","debugId":"d166f748-b8c5-5837-a22e-8a0e34b28c72"}

package/dist/cli/guide-topics.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]="67af0348-fadf-555c-bcd1-6a76796a688d")}catch(e){}}();
 function normalizeTopicToken(value) {
     return value.trim().toLowerCase().replaceAll("_", "-");
 }
@@ -282,4 +284,5 @@ export function resolveGuideTopic(rawTopic) {
     }
     return TOPIC_BY_TOKEN.get(normalized) ?? null;
 }
-//# sourceMappingURL=guide-topics.js.map
+//# sourceMappingURL=guide-topics.js.map
+//# debugId=67af0348-fadf-555c-bcd1-6a76796a688d

package/dist/cli/guide-topics.js.map

@@ -1 +1 @@
-{"version":3,"file":"guide-topics.js","sourceRoot":"/","sources":["cli/guide-topics.ts"],"names":[],"mappings":"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","sourcesContent":["export interface GuideDocReference {\n  path: string;\n  purpose: string;\n  optional?: boolean;\n}\n\nexport interface GuideWorkflowTemplate {\n  name: string;\n  goal: string;\n  prompt: string;\n  commands: string[];\n}\n\nexport interface GuideTopicDefinition {\n  id: string;\n  aliases: string[];\n  title: string;\n  summary: string;\n  intent: string;\n  commands: string[];\n  workflows: GuideWorkflowTemplate[];\n  docs: GuideDocReference[];\n  related: string[];\n}\n\nfunction normalizeTopicToken(value: string): string {\n  return value.trim().toLowerCase().replaceAll(\"_\", \"-\");\n}\n\nconst GUIDE_TOPICS: GuideTopicDefinition[] = [\n  {\n    id: \"quickstart\",\n    aliases: [\"start\", \"getting-started\", \"bootstrap\"],\n    title: \"Quickstart\",\n    summary: \"Initialize a tracker and run the shortest safe plan -> execute -> close loop.\",\n    intent: \"Use this when a human or agent needs to start productive work quickly with minimal context load.\",\n    commands: [\n      \"pm init\",\n      \"pm context --limit 10\",\n      \"pm list-open --limit 20\",\n      \"pm create --create-mode progressive --title \\\"...\\\" --description \\\"...\\\" --type Task\",\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm close <ID> \\\"<reason with evidence>\\\" --validate-close warn\",\n    ],\n    workflows: [\n      {\n        name: \"Start Session Safely\",\n        goal: \"Bootstrap without mutating unrelated state.\",\n        prompt:\n          \"You are bootstrapping pm work. Use a token-efficient context snapshot first, then select one open item, claim it, and only then mutate.\",\n        commands: [\"pm context --limit 10\", \"pm list-open --limit 20\", \"pm claim <ID>\"],\n      },\n    ],\n    docs: [\n      { path: \"README.md\", purpose: \"High-level project and install entrypoint.\" },\n      { path: \"docs/QUICKSTART.md\", purpose: \"Short setup and first-command walkthrough.\" },\n      { path: \"docs/COMMANDS.md\", purpose: \"Task-oriented command recipes.\" },\n    ],\n    related: [\"commands\", \"workflows\", \"release\"],\n  },\n  {\n    id: \"commands\",\n    aliases: [\"cli\", \"operations\", \"reference\"],\n    title: \"CLI Command Routing\",\n    summary: \"Find the right command family quickly and use command-scoped help/contracts output.\",\n    intent: \"Use this when selecting command paths, flags, and output formats for implementation or automation.\",\n    commands: [\n      \"pm --help\",\n      \"pm <command> --help\",\n      \"pm <command> --help --explain\",\n      \"pm contracts --command <command> --flags-only\",\n      \"pm contracts --command <command> --availability-only --runtime-only\",\n      \"pm completion <bash|zsh|fish>\",\n    ],\n    workflows: [\n      {\n        name: \"Flag Discovery\",\n        goal: \"Resolve command flags deterministically before mutations.\",\n        prompt:\n          \"You are preparing to run a command. Use help and contracts surfaces to verify required/optional flags before execution.\",\n        commands: [\"pm <command> --help --explain\", \"pm contracts --command <command> --flags-only\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/COMMANDS.md\", purpose: \"Command grouping and examples.\" },\n      { path: \"docs/CONFIGURATION.md\", purpose: \"Project/global settings and policy controls.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Linked-test orchestration and safety guidance.\" },\n    ],\n    related: [\"quickstart\", \"workflows\", \"sdk\", \"extensions\"],\n  },\n  {\n    id: \"workflows\",\n    aliases: [\"developer\", \"maintainer\", \"agent\"],\n    title: \"Developer and Agent Workflows\",\n    summary: \"Apply canonical claim -> execute -> verify -> close workflows with append-only evidence.\",\n    intent: \"Use this for day-to-day coding-agent execution loops and handoff-safe updates.\",\n    commands: [\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm files <ID> --add ...\",\n      \"pm test <ID> --add ...\",\n      \"pm comments <ID> \\\"...\\\"\",\n      \"pm validate --check-resolution --check-history-drift\",\n      \"pm release <ID>\",\n    ],\n    workflows: [\n      {\n        name: \"Execution Loop\",\n        goal: \"Keep code, tests, and tracker evidence synchronized.\",\n        prompt:\n          \"You are implementing a scoped change. Claim first, link files/tests/docs as you go, append evidence comments, and close only after validation.\",\n        commands: [\n          \"pm claim <ID>\",\n          \"pm update <ID> --status in_progress\",\n          \"pm files <ID> --add path=<file>,scope=project\",\n          \"pm test <ID> --run --progress\",\n          \"pm close <ID> \\\"<evidence>\\\" --validate-close warn\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"AGENTS.md\", purpose: \"Repository operating rules and required workflow.\" },\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-oriented usage and context strategy.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Sandbox-safe test execution rules.\" },\n    ],\n    related: [\"quickstart\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"sdk\",\n    aliases: [\"api\", \"typescript-sdk\"],\n    title: \"SDK and Integrations\",\n    summary: \"Use the published SDK surface for extension authoring and contract-safe integrations.\",\n    intent: \"Use this when building or reviewing programmatic integrations against @unbrained/pm-cli/sdk.\",\n    commands: [\n      \"pm contracts --schema-only\",\n      \"pm contracts --command extension --flags-only\",\n      \"pm contracts --runtime-only --availability-only\",\n    ],\n    workflows: [\n      {\n        name: \"Integration Contract Check\",\n        goal: \"Confirm action schemas and runtime availability before coding.\",\n        prompt:\n          \"You are wiring an integration. Capture schema + runtime availability first, then map your adapter payload fields to contract keys.\",\n        commands: [\n          \"pm contracts --schema-only\",\n          \"pm contracts --availability-only --runtime-only\",\n          \"pm contracts --command <command> --flags-only\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/SDK.md\", purpose: \"Public SDK exports and extension authoring references.\" },\n      { path: \"docs/ARCHITECTURE.md\", purpose: \"Core runtime composition and extension load flow.\" },\n    ],\n    related: [\"extensions\", \"commands\"],\n  },\n  {\n    id: \"extensions\",\n    aliases: [\"plugins\", \"extension-authoring\", \"packages\", \"package-authoring\"],\n    title: \"Packages and Extensions\",\n    summary: \"Install, author, and diagnose packages/extensions with deterministic lifecycle controls.\",\n    intent: \"Use this for package management, extension capability registration, and runtime diagnostics.\",\n    commands: [\n      \"pm install <target> --project\",\n      \"pm upgrade --dry-run\",\n      \"pm package explore --project\",\n      \"pm package manage --detail summary\",\n      \"pm package doctor --detail deep\",\n      \"pm package activate <target> --project\",\n      \"pm package deactivate <target> --project\",\n    ],\n    workflows: [\n      {\n        name: \"Lifecycle Triage\",\n        goal: \"Diagnose extension state before forceful lifecycle actions.\",\n        prompt:\n          \"You are debugging package behavior. Inspect managed state first, then run doctor diagnostics, then apply install/adopt/activate actions.\",\n        commands: [\n          \"pm package explore --project\",\n          \"pm package manage --detail summary\",\n          \"pm package doctor --detail deep\",\n          \"pm upgrade --packages-only --dry-run\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/EXTENSIONS.md\", purpose: \"Capability model and lifecycle command usage.\" },\n      {\n        path: \"docs/examples/starter-extension/README.md\",\n        purpose: \"Starter extension scaffold and local development path.\",\n      },\n      { path: \"docs/SDK.md\", purpose: \"SDK contracts used by extension implementations.\" },\n    ],\n    related: [\"sdk\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"skills\",\n    aliases: [\"agent-skills\", \"agentskills\"],\n    title: \"Agent Skills\",\n    summary: \"Skill bundles for developer, user, extensions, and sdk workflows aligned to the current CLI.\",\n    intent: \"Use this when an agent needs reproducible prompts/workflows with strict compatibility metadata.\",\n    commands: [\n      \"pm guide skills --depth deep\",\n      \"pm contracts --command guide --flags-only\",\n      \"pm validate --check-command-references\",\n    ],\n    workflows: [\n      {\n        name: \"Skill Selection\",\n        goal: \"Pick the narrowest compatible skill first to minimize context usage.\",\n        prompt:\n          \"Select a pm skill based on the task intent, then execute only the workflow section needed for the current change.\",\n        commands: [\"pm guide skills\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-first usage and context model.\" },\n      { path: \"docs/README.md\", purpose: \"Documentation routing with progressive disclosure.\" },\n      { path: \".agents/skills/README.md\", purpose: \"Agent skills index and routing overview.\" },\n      { path: \".agents/skills/pm-developer/SKILL.md\", purpose: \"Developer-oriented pm skill workflow.\" },\n      { path: \".agents/skills/pm-user/SKILL.md\", purpose: \"User/operator pm skill workflow.\" },\n      { path: \".agents/skills/pm-extensions/SKILL.md\", purpose: \"Extension-focused pm skill workflow.\" },\n      { path: \".agents/skills/pm-sdk/SKILL.md\", purpose: \"SDK integration pm skill workflow.\" },\n    ],\n    related: [\"workflows\", \"harnesses\", \"commands\"],\n  },\n  {\n    id: \"harnesses\",\n    aliases: [\"compatibility\", \"agent-compatibility\"],\n    title: \"Agent Harness Compatibility\",\n    summary: \"Cross-harness compatibility guidance for docs routing.\",\n    intent: \"Use this when adapting pm docs and SDK contracts for an external automation harness.\",\n    commands: [\"pm guide skills\", \"pm guide commands\", \"pm contracts --runtime-only --availability-only\"],\n    workflows: [\n      {\n        name: \"Harness Mapping\",\n        goal: \"Route each harness to the same canonical skill/docs sources.\",\n        prompt:\n          \"Map harness-specific entrypoints to the same pm guide topics and .agents/skills workflows without adding runtime harness-specific code.\",\n        commands: [\"pm guide harnesses --depth standard\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent context and output-mode conventions.\" },\n      { path: \"docs/README.md\", purpose: \"Single-source documentation routing entrypoint.\" },\n      { path: \".agents/skills/HARNESS_COMPATIBILITY.md\", purpose: \"Harness compatibility matrix and usage notes.\" },\n    ],\n    related: [\"skills\", \"workflows\"],\n  },\n  {\n    id: \"release\",\n    aliases: [\"gates\", \"ship\", \"release-readiness\"],\n    title: \"Release and Staleness Gates\",\n    summary: \"Run release gates and docs/skills freshness checks before publishing.\",\n    intent: \"Use this when validating release readiness and preventing docs/skills drift.\",\n    commands: [\n      \"pnpm build\",\n      \"pnpm test:coverage\",\n      \"pnpm quality:static\",\n      \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n      \"pnpm security:scan\",\n    ],\n    workflows: [\n      {\n        name: \"Pre-Release Gate Sweep\",\n        goal: \"Ensure code, docs, and skills are all green before publish.\",\n        prompt:\n          \"Run release gates in deterministic order and treat docs/skills freshness failures as release blockers.\",\n        commands: [\n          \"pnpm build\",\n          \"pnpm test:coverage\",\n          \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/RELEASING.md\", purpose: \"Release flow and safety checks.\" },\n      { path: \"CHANGELOG.md\", purpose: \"Versioned release history and unreleased notes.\" },\n      { path: \"scripts/release/run-gates.mjs\", purpose: \"Source of truth for release gate ordering.\" },\n    ],\n    related: [\"commands\", \"skills\", \"workflows\"],\n  },\n];\n\nconst TOPIC_BY_TOKEN = new Map<string, GuideTopicDefinition>();\nfor (const topic of GUIDE_TOPICS) {\n  TOPIC_BY_TOKEN.set(topic.id, topic);\n  for (const alias of topic.aliases) {\n    TOPIC_BY_TOKEN.set(alias, topic);\n  }\n}\n\nexport function listGuideTopics(): GuideTopicDefinition[] {\n  return GUIDE_TOPICS.map((topic) => ({\n    ...topic,\n    aliases: [...topic.aliases],\n    commands: [...topic.commands],\n    workflows: topic.workflows.map((workflow) => ({\n      ...workflow,\n      commands: [...workflow.commands],\n    })),\n    docs: topic.docs.map((doc) => ({ ...doc })),\n    related: [...topic.related],\n  }));\n}\n\nexport function listGuideTopicIds(): string[] {\n  return GUIDE_TOPICS.map((topic) => topic.id);\n}\n\nexport function resolveGuideTopic(rawTopic: string | undefined): GuideTopicDefinition | null {\n  if (!rawTopic) {\n    return null;\n  }\n  const normalized = normalizeTopicToken(rawTopic);\n  if (!normalized) {\n    return null;\n  }\n  return TOPIC_BY_TOKEN.get(normalized) ?? null;\n}\n"]}
+{"version":3,"file":"guide-topics.js","sources":["cli/guide-topics.ts"],"sourceRoot":"/","sourcesContent":["export interface GuideDocReference {\n  path: string;\n  purpose: string;\n  optional?: boolean;\n}\n\nexport interface GuideWorkflowTemplate {\n  name: string;\n  goal: string;\n  prompt: string;\n  commands: string[];\n}\n\nexport interface GuideTopicDefinition {\n  id: string;\n  aliases: string[];\n  title: string;\n  summary: string;\n  intent: string;\n  commands: string[];\n  workflows: GuideWorkflowTemplate[];\n  docs: GuideDocReference[];\n  related: string[];\n}\n\nfunction normalizeTopicToken(value: string): string {\n  return value.trim().toLowerCase().replaceAll(\"_\", \"-\");\n}\n\nconst GUIDE_TOPICS: GuideTopicDefinition[] = [\n  {\n    id: \"quickstart\",\n    aliases: [\"start\", \"getting-started\", \"bootstrap\"],\n    title: \"Quickstart\",\n    summary: \"Initialize a tracker and run the shortest safe plan -> execute -> close loop.\",\n    intent: \"Use this when a human or agent needs to start productive work quickly with minimal context load.\",\n    commands: [\n      \"pm init\",\n      \"pm context --limit 10\",\n      \"pm list-open --limit 20\",\n      \"pm create --create-mode progressive --title \\\"...\\\" --description \\\"...\\\" --type Task\",\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm close <ID> \\\"<reason with evidence>\\\" --validate-close warn\",\n    ],\n    workflows: [\n      {\n        name: \"Start Session Safely\",\n        goal: \"Bootstrap without mutating unrelated state.\",\n        prompt:\n          \"You are bootstrapping pm work. Use a token-efficient context snapshot first, then select one open item, claim it, and only then mutate.\",\n        commands: [\"pm context --limit 10\", \"pm list-open --limit 20\", \"pm claim <ID>\"],\n      },\n    ],\n    docs: [\n      { path: \"README.md\", purpose: \"High-level project and install entrypoint.\" },\n      { path: \"docs/QUICKSTART.md\", purpose: \"Short setup and first-command walkthrough.\" },\n      { path: \"docs/COMMANDS.md\", purpose: \"Task-oriented command recipes.\" },\n    ],\n    related: [\"commands\", \"workflows\", \"release\"],\n  },\n  {\n    id: \"commands\",\n    aliases: [\"cli\", \"operations\", \"reference\"],\n    title: \"CLI Command Routing\",\n    summary: \"Find the right command family quickly and use command-scoped help/contracts output.\",\n    intent: \"Use this when selecting command paths, flags, and output formats for implementation or automation.\",\n    commands: [\n      \"pm --help\",\n      \"pm <command> --help\",\n      \"pm <command> --help --explain\",\n      \"pm contracts --command <command> --flags-only\",\n      \"pm contracts --command <command> --availability-only --runtime-only\",\n      \"pm completion <bash|zsh|fish>\",\n    ],\n    workflows: [\n      {\n        name: \"Flag Discovery\",\n        goal: \"Resolve command flags deterministically before mutations.\",\n        prompt:\n          \"You are preparing to run a command. Use help and contracts surfaces to verify required/optional flags before execution.\",\n        commands: [\"pm <command> --help --explain\", \"pm contracts --command <command> --flags-only\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/COMMANDS.md\", purpose: \"Command grouping and examples.\" },\n      { path: \"docs/CONFIGURATION.md\", purpose: \"Project/global settings and policy controls.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Linked-test orchestration and safety guidance.\" },\n    ],\n    related: [\"quickstart\", \"workflows\", \"sdk\", \"extensions\"],\n  },\n  {\n    id: \"workflows\",\n    aliases: [\"developer\", \"maintainer\", \"agent\"],\n    title: \"Developer and Agent Workflows\",\n    summary: \"Apply canonical claim -> execute -> verify -> close workflows with append-only evidence.\",\n    intent: \"Use this for day-to-day coding-agent execution loops and handoff-safe updates.\",\n    commands: [\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm files <ID> --add ...\",\n      \"pm test <ID> --add ...\",\n      \"pm comments <ID> \\\"...\\\"\",\n      \"pm validate --check-resolution --check-history-drift\",\n      \"pm release <ID>\",\n    ],\n    workflows: [\n      {\n        name: \"Execution Loop\",\n        goal: \"Keep code, tests, and tracker evidence synchronized.\",\n        prompt:\n          \"You are implementing a scoped change. Claim first, link files/tests/docs as you go, append evidence comments, and close only after validation.\",\n        commands: [\n          \"pm claim <ID>\",\n          \"pm update <ID> --status in_progress\",\n          \"pm files <ID> --add path=<file>,scope=project\",\n          \"pm test <ID> --run --progress\",\n          \"pm close <ID> \\\"<evidence>\\\" --validate-close warn\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"AGENTS.md\", purpose: \"Repository operating rules and required workflow.\" },\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-oriented usage and context strategy.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Sandbox-safe test execution rules.\" },\n    ],\n    related: [\"quickstart\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"sdk\",\n    aliases: [\"api\", \"typescript-sdk\"],\n    title: \"SDK and Integrations\",\n    summary: \"Use the published SDK surface for extension authoring and contract-safe integrations.\",\n    intent: \"Use this when building or reviewing programmatic integrations against @unbrained/pm-cli/sdk.\",\n    commands: [\n      \"pm contracts --schema-only\",\n      \"pm contracts --command extension --flags-only\",\n      \"pm contracts --runtime-only --availability-only\",\n    ],\n    workflows: [\n      {\n        name: \"Integration Contract Check\",\n        goal: \"Confirm action schemas and runtime availability before coding.\",\n        prompt:\n          \"You are wiring an integration. Capture schema + runtime availability first, then map your adapter payload fields to contract keys.\",\n        commands: [\n          \"pm contracts --schema-only\",\n          \"pm contracts --availability-only --runtime-only\",\n          \"pm contracts --command <command> --flags-only\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/SDK.md\", purpose: \"Public SDK exports and extension authoring references.\" },\n      { path: \"docs/ARCHITECTURE.md\", purpose: \"Core runtime composition and extension load flow.\" },\n    ],\n    related: [\"extensions\", \"commands\"],\n  },\n  {\n    id: \"extensions\",\n    aliases: [\"plugins\", \"extension-authoring\", \"packages\", \"package-authoring\"],\n    title: \"Packages and Extensions\",\n    summary: \"Install, author, and diagnose packages/extensions with deterministic lifecycle controls.\",\n    intent: \"Use this for package management, extension capability registration, and runtime diagnostics.\",\n    commands: [\n      \"pm install <target> --project\",\n      \"pm upgrade --dry-run\",\n      \"pm package explore --project\",\n      \"pm package manage --detail summary\",\n      \"pm package doctor --detail deep\",\n      \"pm package activate <target> --project\",\n      \"pm package deactivate <target> --project\",\n    ],\n    workflows: [\n      {\n        name: \"Lifecycle Triage\",\n        goal: \"Diagnose extension state before forceful lifecycle actions.\",\n        prompt:\n          \"You are debugging package behavior. Inspect managed state first, then run doctor diagnostics, then apply install/adopt/activate actions.\",\n        commands: [\n          \"pm package explore --project\",\n          \"pm package manage --detail summary\",\n          \"pm package doctor --detail deep\",\n          \"pm upgrade --packages-only --dry-run\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/EXTENSIONS.md\", purpose: \"Capability model and lifecycle command usage.\" },\n      {\n        path: \"docs/examples/starter-extension/README.md\",\n        purpose: \"Starter extension scaffold and local development path.\",\n      },\n      { path: \"docs/SDK.md\", purpose: \"SDK contracts used by extension implementations.\" },\n    ],\n    related: [\"sdk\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"skills\",\n    aliases: [\"agent-skills\", \"agentskills\"],\n    title: \"Agent Skills\",\n    summary: \"Skill bundles for developer, user, extensions, and sdk workflows aligned to the current CLI.\",\n    intent: \"Use this when an agent needs reproducible prompts/workflows with strict compatibility metadata.\",\n    commands: [\n      \"pm guide skills --depth deep\",\n      \"pm contracts --command guide --flags-only\",\n      \"pm validate --check-command-references\",\n    ],\n    workflows: [\n      {\n        name: \"Skill Selection\",\n        goal: \"Pick the narrowest compatible skill first to minimize context usage.\",\n        prompt:\n          \"Select a pm skill based on the task intent, then execute only the workflow section needed for the current change.\",\n        commands: [\"pm guide skills\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-first usage and context model.\" },\n      { path: \"docs/README.md\", purpose: \"Documentation routing with progressive disclosure.\" },\n      { path: \".agents/skills/README.md\", purpose: \"Agent skills index and routing overview.\" },\n      { path: \".agents/skills/pm-developer/SKILL.md\", purpose: \"Developer-oriented pm skill workflow.\" },\n      { path: \".agents/skills/pm-user/SKILL.md\", purpose: \"User/operator pm skill workflow.\" },\n      { path: \".agents/skills/pm-extensions/SKILL.md\", purpose: \"Extension-focused pm skill workflow.\" },\n      { path: \".agents/skills/pm-sdk/SKILL.md\", purpose: \"SDK integration pm skill workflow.\" },\n    ],\n    related: [\"workflows\", \"harnesses\", \"commands\"],\n  },\n  {\n    id: \"harnesses\",\n    aliases: [\"compatibility\", \"agent-compatibility\"],\n    title: \"Agent Harness Compatibility\",\n    summary: \"Cross-harness compatibility guidance for docs routing.\",\n    intent: \"Use this when adapting pm docs and SDK contracts for an external automation harness.\",\n    commands: [\"pm guide skills\", \"pm guide commands\", \"pm contracts --runtime-only --availability-only\"],\n    workflows: [\n      {\n        name: \"Harness Mapping\",\n        goal: \"Route each harness to the same canonical skill/docs sources.\",\n        prompt:\n          \"Map harness-specific entrypoints to the same pm guide topics and .agents/skills workflows without adding runtime harness-specific code.\",\n        commands: [\"pm guide harnesses --depth standard\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent context and output-mode conventions.\" },\n      { path: \"docs/README.md\", purpose: \"Single-source documentation routing entrypoint.\" },\n      { path: \".agents/skills/HARNESS_COMPATIBILITY.md\", purpose: \"Harness compatibility matrix and usage notes.\" },\n    ],\n    related: [\"skills\", \"workflows\"],\n  },\n  {\n    id: \"release\",\n    aliases: [\"gates\", \"ship\", \"release-readiness\"],\n    title: \"Release and Staleness Gates\",\n    summary: \"Run release gates and docs/skills freshness checks before publishing.\",\n    intent: \"Use this when validating release readiness and preventing docs/skills drift.\",\n    commands: [\n      \"pnpm build\",\n      \"pnpm test:coverage\",\n      \"pnpm quality:static\",\n      \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n      \"pnpm security:scan\",\n    ],\n    workflows: [\n      {\n        name: \"Pre-Release Gate Sweep\",\n        goal: \"Ensure code, docs, and skills are all green before publish.\",\n        prompt:\n          \"Run release gates in deterministic order and treat docs/skills freshness failures as release blockers.\",\n        commands: [\n          \"pnpm build\",\n          \"pnpm test:coverage\",\n          \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/RELEASING.md\", purpose: \"Release flow and safety checks.\" },\n      { path: \"CHANGELOG.md\", purpose: \"Versioned release history and unreleased notes.\" },\n      { path: \"scripts/release/run-gates.mjs\", purpose: \"Source of truth for release gate ordering.\" },\n    ],\n    related: [\"commands\", \"skills\", \"workflows\"],\n  },\n];\n\nconst TOPIC_BY_TOKEN = new Map<string, GuideTopicDefinition>();\nfor (const topic of GUIDE_TOPICS) {\n  TOPIC_BY_TOKEN.set(topic.id, topic);\n  for (const alias of topic.aliases) {\n    TOPIC_BY_TOKEN.set(alias, topic);\n  }\n}\n\nexport function listGuideTopics(): GuideTopicDefinition[] {\n  return GUIDE_TOPICS.map((topic) => ({\n    ...topic,\n    aliases: [...topic.aliases],\n    commands: [...topic.commands],\n    workflows: topic.workflows.map((workflow) => ({\n      ...workflow,\n      commands: [...workflow.commands],\n    })),\n    docs: topic.docs.map((doc) => ({ ...doc })),\n    related: [...topic.related],\n  }));\n}\n\nexport function listGuideTopicIds(): string[] {\n  return GUIDE_TOPICS.map((topic) => topic.id);\n}\n\nexport function resolveGuideTopic(rawTopic: string | undefined): GuideTopicDefinition | null {\n  if (!rawTopic) {\n    return null;\n  }\n  const normalized = normalizeTopicToken(rawTopic);\n  if (!normalized) {\n    return null;\n  }\n  return TOPIC_BY_TOKEN.get(normalized) ?? null;\n}\n"],"names":[],"mappings":"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","debugId":"67af0348-fadf-555c-bcd1-6a76796a688d"}

package/dist/cli/help-content.d.ts

@@ -16,5 +16,4 @@ export declare function resolveHelpDetailMode(argv: string[]): HelpDetailMode;
 export declare const ROOT_HELP_BUNDLE: HelpBundle;
 export declare function resolveHelpBundleForPath(commandPath: string | undefined): HelpBundle;
 export declare function resolveHelpNarrative(commandPath: string | undefined, detailMode: HelpDetailMode): HelpNarrative;
-export declare function listDocumentedHelpPaths(): string[];
 export declare function attachRichHelpText(program: Command, argv?: string[]): void;

package/dist/cli/help-content.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]="87ab8982-4eaf-5b48-88af-96ff4450ab0f")}catch(e){}}();
 function renderCompactHelpBundle(bundle) {
     const lines = [
         "",
@@ -75,10 +77,18 @@ export function resolveHelpDetailMode(argv) {
 const HELP_BY_COMMAND_PATH = {
     init: {
         why: "Bootstraps tracker storage and settings so all other commands can run safely.",
-        examples: ['pm init', 'pm init acme', "pm init --preset minimal", "pm init --preset strict"],
+        examples: [
+            "pm init",
+            "pm init acme",
+            "pm init --preset minimal",
+            "pm init --agent-guidance add",
+            "pm init --defaults --with-packages",
+        ],
         tips: [
             "Run this once per repository before create/list/update commands.",
             "Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.",
+            "Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.",
+            "Use --with-packages when agents need bundled commands such as calendar and templates available immediately.",
         ],
     },
     config: {
@@ -165,7 +175,7 @@ const HELP_BY_COMMAND_PATH = {
         examples: [
             'pm create --title "Harden lock flow" --description "Improve stale lock handling" --type Task --status open --priority 1 --message "Create lock hardening task" --create-mode progressive',
             'pm create --title "Weekly planning sync" --description "Recurring coordination meeting" --type Meeting --schedule-preset lightweight',
-            'pm create --title "Asset: Hero model" --description "Track playable model asset" --type Asset --status open --priority 1 --message "Create asset item" --type-option category=Character --dep "id=pm-epic01,kind=parent,author=codex-agent,created_at=now" --comment "author=codex-agent,created_at=now,text=Why this asset item exists." --note "author=codex-agent,created_at=now,text=Initial implementation note." --learning "author=codex-agent,created_at=now,text=Durable lesson placeholder." --file "path=src/assets/hero.glb,scope=project,note=tracked asset" --test "command=node scripts/run-tests.mjs test,scope=project,timeout_seconds=240" --doc "path=README.md,scope=project,note=asset docs"',
+            'pm create --title "Asset: Hero model" --description "Track playable model asset" --type Asset --status open --priority 1 --message "Create asset item" --type-option category=Character --dep "id=pm-epic01,kind=parent,author=codex-agent,created_at=now" --comment "author=codex-agent,created_at=now,text=Why this asset item exists." --note "author=codex-agent,created_at=now,text=Initial implementation note." --learning "author=codex-agent,created_at=now,text=Durable lesson placeholder." --file "path=src/assets/hero.glb,note=tracked asset" --test "command=node scripts/run-tests.mjs test,timeout_seconds=240" --doc "path=README.md,note=asset docs"',
         ],
         tips: [
             "Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.",
@@ -190,7 +200,7 @@ const HELP_BY_COMMAND_PATH = {
         why: "Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.",
         examples: [
             "pm update-many --filter-status open --status in_progress --dry-run",
-            'pm update-many --filter-tag wave:7 --replace-tests --test "command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,scope=project,timeout_seconds=240"',
+            'pm update-many --filter-tag wave:7 --replace-tests --test "command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,timeout_seconds=240"',
             'pm update-many --filter-tag governance --reviewer maintainer-review --message "Normalize reviewer metadata"',
             "pm update-many --rollback ckpt-abc123",
         ],
@@ -291,6 +301,7 @@ const HELP_BY_COMMAND_PATH = {
     guide: {
         why: "Routes local progressive-disclosure documentation so agents can fetch only the context they need.",
         examples: [
+            "pm install guide-shell --project",
             "pm guide",
             "pm guide quickstart",
             "pm guide commands --depth standard",
@@ -326,7 +337,7 @@ const HELP_BY_COMMAND_PATH = {
             "pm context --from +0d --to +7d --format markdown --depth deep",
         ],
         tips: [
-            "High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Event/Reminder/Milestone/Meeting.",
+            "High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Decisions/Event/Reminder/Milestone/Meeting/Plan.",
             "When no open or in-progress work exists, blocked items are shown as fallback context.",
             "--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.",
             "--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.",
@@ -354,18 +365,27 @@ const HELP_BY_COMMAND_PATH = {
         ],
     },
     get: {
-        why: "Shows complete details for one item by ID.",
-        examples: ["pm get pm-a1b2", "pm get pm-a1b2 --json"],
-        tips: ["JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body)."],
+        why: "Shows details for one item by ID, with optional lower-token projections for agent loops.",
+        examples: [
+            "pm get pm-a1b2",
+            "pm get pm-a1b2 --depth brief --json",
+            "pm get pm-a1b2 --fields id,title,status,parent,type --json",
+        ],
+        tips: [
+            "Default depth is deep for backward compatibility; use brief for metadata-only checks and standard for body plus linked artifacts without append-only logs.",
+            "Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.",
+            "JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).",
+        ],
     },
     history: {
         why: "Inspects item mutation timeline and audit trail.",
-        examples: ["pm history pm-a1b2 --limit 20"],
+        examples: ["pm history pm-a1b2 --limit 20", "pm history pm-a1b2 --full --verify"],
     },
     activity: {
         why: "Reviews recent tracker-wide activity across items.",
         examples: [
             "pm activity --limit 50",
+            "pm activity --full --id pm-a1b2 --limit 50",
             "pm activity --id pm-a1b2 --op update --author codex-agent --from -7d --to now",
             "pm activity --json --stream rows --limit 200",
         ],
@@ -450,21 +470,21 @@ const HELP_BY_COMMAND_PATH = {
     files: {
         why: "Associates changed source files with tracker items for reproducibility.",
         examples: [
-            'pm files pm-a1b2 --add "path=src/cli/main.ts,scope=project,note=help orchestration"',
+            'pm files pm-a1b2 --add "path=src/cli/main.ts,note=help orchestration"',
             "pm files discover pm-a1b2",
             'pm files discover pm-a1b2 --apply --note "discovered from item text"',
         ],
     },
     docs: {
         why: "Associates relevant documentation paths with tracker items.",
-        examples: ['pm docs pm-a1b2 --add "path=README.md,scope=project,note=user-facing command guidance"'],
+        examples: ['pm docs pm-a1b2 --add "path=README.md,note=user-facing command guidance"'],
     },
     test: {
         why: "Links test commands/paths and optionally executes them for one item.",
         examples: [
-            'pm test pm-a1b2 --add "command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,scope=project,timeout_seconds=2400"',
-            'pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,scope=project,assert_stdout_contains=count:,assert_stdout_regex=count:\\s+\\d+"',
-            'pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,scope=project,pm_context_mode=auto"',
+            'pm test pm-a1b2 --add "command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,timeout_seconds=2400"',
+            'pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\s+\\d+"',
+            'pm test pm-a1b2 --add "command=pm list-all --type Task --limit 200,pm_context_mode=auto"',
             "pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped",
             "pm test pm-a1b2 --run --timeout 2400 --pm-context auto",
             "pm test pm-a1b2 --run --background --timeout 2400 --progress",
@@ -496,7 +516,13 @@ const HELP_BY_COMMAND_PATH = {
     },
     health: {
         why: "Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.",
-        examples: ["pm health", "pm health --json", "pm health --check-only", "pm health --no-refresh", "pm health --refresh-vectors"],
+        examples: [
+            "pm health",
+            "pm health --check-only --summary --json",
+            "pm health --brief --json",
+            "pm health --no-refresh",
+            "pm health --refresh-vectors",
+        ],
     },
     validate: {
         why: "Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.",
@@ -512,8 +538,8 @@ const HELP_BY_COMMAND_PATH = {
         tips: ["Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details."],
     },
     gc: {
-        why: "Cleans optional cache artifacts to keep local tracker state tidy.",
-        examples: ["pm gc"],
+        why: "Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.",
+        examples: ["pm gc --dry-run", "pm gc"],
     },
     claim: {
         why: "Claims an item to signal active ownership and reduce conflicts.",
@@ -565,13 +591,13 @@ export const ROOT_HELP_BUNDLE = {
     why: "Provides deterministic project management workflows for humans and coding agents.",
     examples: [
         "pm init",
-        "pm guide",
+        "pm install guide-shell --project",
         "pm list-open --limit 10",
         'pm create --title "..." --description "..." --type Task --status open --priority 1 --message "..." --create-mode progressive',
     ],
     tips: [
         "Use <command> --help for command-specific guidance and examples.",
-        "Use pm guide for local docs and skills routing with progressive disclosure.",
+        "Install guide-shell before using pm guide for local docs and skills routing.",
         "Use --json for machine parsing and integration flows.",
         "Use --no-pager to force direct help output in CI and other non-interactive shells.",
     ],
@@ -599,9 +625,6 @@ export function resolveHelpNarrative(commandPath, detailMode) {
         detail_mode: detailMode,
     };
 }
-export function listDocumentedHelpPaths() {
-    return Object.keys(HELP_BY_COMMAND_PATH).sort((left, right) => left.localeCompare(right));
-}
 export function attachRichHelpText(program, argv = process.argv.slice(2)) {
     const detailMode = resolveHelpDetailMode(argv);
     program.addHelpText("after", renderHelpBundle(ROOT_HELP_BUNDLE, detailMode));
@@ -609,4 +632,5 @@ export function attachRichHelpText(program, argv = process.argv.slice(2)) {
         attachBundleByPath(program, commandPath, bundle, detailMode);
     }
 }
-//# sourceMappingURL=help-content.js.map
+//# sourceMappingURL=help-content.js.map
+//# debugId=87ab8982-4eaf-5b48-88af-96ff4450ab0f