@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/sdk/author-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"author-attribution.js","sources":["sdk/author-attribution.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/author-attribution\n *\n * Provides reusable diagnostics for mutation-author provenance in tracker history.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** First release-governance anchor after which unknown authors require remediation. */\nexport const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = \"2026-07-15T06:22:12.276Z\";\n\n/** Parsed epoch for the immutable attribution baseline used by every stream scan. */\nconst HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS = Date.parse(\n  HISTORY_AUTHOR_ATTRIBUTION_BASELINE,\n);\n\n/** Attribution policy indexed by unknown-author and post-baseline flags. */\nconst HISTORY_AUTHOR_EVENT_CLASSIFICATIONS = [\n  [\"attributed\", \"attributed\"],\n  [\"legacy_unknown\", \"actionable_unknown\"],\n] as const;\n\n/** Return history string fields unchanged while normalizing other values to empty text. */\nconst historyStringValue = (value: unknown): string =>\n  typeof value === \"string\" ? value : \"\";\n\n/** Identifies one history event whose mutation author is absent or explicitly unknown. */\nexport interface UnknownAuthorHistoryEvent {\n  /** Item whose history stream contains the event. */\n  item_id: string;\n  /** One-based JSONL line number. */\n  line: number;\n}\n\n/** Summarizes mutation-author provenance across all readable tracker history streams. */\nexport interface HistoryAuthorAttributionScan {\n  /** Number of readable history streams inspected. */\n  checked_streams: number;\n  /** Number of non-empty history events inspected. */\n  checked_events: number;\n  /** Number of events without attributable authorship. */\n  unknown_event_count: number;\n  /** Immutable pre-baseline events retained as historical information. */\n  legacy_unknown_event_count: number;\n  /** Timestamped post-baseline events that require author-attribution fixes. */\n  actionable_unknown_event_count: number;\n  /** Stable, sorted item ids containing unknown-author events. */\n  affected_item_ids: string[];\n  /** Bounded examples suitable for diagnostic output. */\n  samples: UnknownAuthorHistoryEvent[];\n}\n\n/** Classifies one parsed history event by author provenance and baseline age. */\nexport const classifyHistoryAuthorEvent = (\n  parsed: unknown,\n): \"attributed\" | \"legacy_unknown\" | \"actionable_unknown\" => {\n  const record = (parsed ?? {}) as { author?: unknown; ts?: unknown };\n  const author = historyStringValue(record.author).trim().toLowerCase();\n  const authorClass = Number([\"\", \"unknown\"].includes(author)) as 0 | 1;\n  const timestampClass = Number(\n    Date.parse(historyStringValue(record.ts)) >=\n      HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS,\n  ) as 0 | 1;\n  return HISTORY_AUTHOR_EVENT_CLASSIFICATIONS[authorClass][timestampClass];\n};\n\n/** Inspect one readable JSONL stream without performing filesystem I/O. */\nexport const inspectHistoryAuthorStream = (\n  itemId: string,\n  raw: string,\n  sampleLimit = 20,\n): Pick<\n  HistoryAuthorAttributionScan,\n  | \"checked_events\"\n  | \"unknown_event_count\"\n  | \"legacy_unknown_event_count\"\n  | \"actionable_unknown_event_count\"\n  | \"samples\"\n> => {\n  const samples: UnknownAuthorHistoryEvent[] = [];\n  const unknownCounts = {\n    legacy_unknown: 0,\n    actionable_unknown: 0,\n  };\n  const boundedSampleLimit = Math.max(0, sampleLimit);\n  let checkedEvents = 0;\n  for (const [index, line] of raw.split(/\\r?\\n/).entries()) {\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(line);\n    } catch {\n      continue;\n    }\n    checkedEvents += 1;\n    const classification = classifyHistoryAuthorEvent(parsed);\n    if (classification === \"attributed\") {\n      continue;\n    }\n    unknownCounts[classification] += 1;\n    if (samples.length < boundedSampleLimit) {\n      samples.push({ item_id: itemId, line: index + 1 });\n    }\n  }\n  return {\n    checked_events: checkedEvents,\n    unknown_event_count:\n      unknownCounts.legacy_unknown + unknownCounts.actionable_unknown,\n    legacy_unknown_event_count: unknownCounts.legacy_unknown,\n    actionable_unknown_event_count: unknownCounts.actionable_unknown,\n    samples,\n  };\n};\n\n/**\n * Scan append-only tracker history for missing or `unknown` author values.\n * Malformed and unreadable streams are deliberately left to integrity diagnostics.\n */\nexport const scanHistoryAuthorAttribution = async (\n  pmRoot: string,\n  sampleLimit = 20,\n): Promise<HistoryAuthorAttributionScan> => {\n  const historyDirectory = path.join(pmRoot, \"history\");\n  let fileNames: string[];\n  try {\n    fileNames = (await fs.readdir(historyDirectory))\n      .filter((fileName) => fileName.endsWith(\".jsonl\"))\n      .sort((left, right) => left.localeCompare(right));\n  } catch {\n    fileNames = [];\n  }\n  const affectedItemIds = new Set<string>();\n  const samples: UnknownAuthorHistoryEvent[] = [];\n  let checkedStreams = 0;\n  let checkedEvents = 0;\n  let unknownEventCount = 0;\n  let legacyUnknownEventCount = 0;\n  let actionableUnknownEventCount = 0;\n  for (const fileName of fileNames) {\n    let raw: string;\n    try {\n      raw = await fs.readFile(path.join(historyDirectory, fileName), \"utf8\");\n    } catch {\n      continue;\n    }\n    const itemId = fileName.slice(0, -\".jsonl\".length);\n    const inspected = inspectHistoryAuthorStream(\n      itemId,\n      raw,\n      sampleLimit - samples.length,\n    );\n    checkedStreams += 1;\n    checkedEvents += inspected.checked_events;\n    unknownEventCount += inspected.unknown_event_count;\n    legacyUnknownEventCount += inspected.legacy_unknown_event_count;\n    actionableUnknownEventCount += inspected.actionable_unknown_event_count;\n    if (inspected.unknown_event_count > 0) {\n      affectedItemIds.add(itemId);\n    }\n    samples.push(...inspected.samples);\n  }\n  return {\n    checked_streams: checkedStreams,\n    checked_events: checkedEvents,\n    unknown_event_count: unknownEventCount,\n    legacy_unknown_event_count: legacyUnknownEventCount,\n    actionable_unknown_event_count: actionableUnknownEventCount,\n    affected_item_ids: [...affectedItemIds].sort((left, right) =>\n      left.localeCompare(right),\n    ),\n    samples,\n  };\n};\n"],"names":[],"mappings":"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","debugId":"d34bc045-ebaa-5085-ab4e-7866236c2d52"}

package/dist/sdk/cli-contracts/command-aliases.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module sdk/cli-contracts/command-aliases
+ *
+ * Defines executable command aliases shared by bootstrap parsing and SDK package scaffolding.
+ */
+/** High-frequency executable aliases whose targets accept the same positional and flag contracts. */
+export declare const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>>;

package/dist/sdk/cli-contracts/command-aliases.js

@@ -0,0 +1,17 @@
+/**
+ * @module sdk/cli-contracts/command-aliases
+ *
+ * Defines executable command aliases shared by bootstrap parsing and SDK package scaffolding.
+ */
+/** High-frequency executable aliases whose targets accept the same positional and flag contracts. */
+
+!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]="e5081784-d3d0-5fd3-9f6a-294a621995ef")}catch(e){}}();
+export const EXECUTABLE_COMMAND_ALIASES = {
+    show: "get",
+    view: "get",
+    comment: "comments",
+    note: "notes",
+    learning: "learnings",
+};
+//# sourceMappingURL=command-aliases.js.map
+//# debugId=e5081784-d3d0-5fd3-9f6a-294a621995ef

package/dist/sdk/cli-contracts/command-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-aliases.js","sources":["sdk/cli-contracts/command-aliases.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/cli-contracts/command-aliases\n *\n * Defines executable command aliases shared by bootstrap parsing and SDK package scaffolding.\n */\n\n/** High-frequency executable aliases whose targets accept the same positional and flag contracts. */\nexport const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>> = {\n  show: \"get\",\n  view: \"get\",\n  comment: \"comments\",\n  note: \"notes\",\n  learning: \"learnings\",\n};\n"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qGAAqG;;;AACrG,MAAM,CAAC,MAAM,0BAA0B,GAAqC;IAC1E,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,WAAW;CACtB,CAAC","debugId":"e5081784-d3d0-5fd3-9f6a-294a621995ef"}

package/dist/sdk/cli-contracts/flag-contracts.js

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="e9f582fa-4daa-55e7-8019-d302301d54cd")}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]="cb1e2010-bf9f-5eb9-a77d-70e31f5463ac")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 function normalizeFlagAliasKey(flag) {
     if (!flag.startsWith("--")) {
@@ -73,6 +73,7 @@ export const SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = [
     { flag: "--no-pager" },
     { flag: "--profile" },
     { flag: "--help" },
+    { flag: "--author", value_name: "id" },
 ];
 /** Public contract for global flag contracts, shared by SDK and presentation-layer consumers. */
 export const GLOBAL_FLAG_CONTRACTS = [
@@ -396,6 +397,7 @@ export const PLAN_FLAG_CONTRACTS = [
 ];
 /** Public contract for init flag contracts, shared by SDK and presentation-layer consumers. */
 export const INIT_FLAG_CONTRACTS = [
+    { flag: "--id-prefix", aliases: ["--prefix"] },
     { flag: "--preset" },
     { flag: "--type-preset" },
     { flag: "--defaults", short: "-y", aliases: ["--yes"] },
@@ -1219,6 +1221,7 @@ export const GET_FLAG_CONTRACTS = [
     { flag: "--depth" },
     { flag: "--full" },
     { flag: "--fields", list: true },
+    { flag: "--at" },
     { flag: "--tree" },
     { flag: "--tree-depth" },
     { flag: "--tree_depth" },
@@ -1487,4 +1490,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=e9f582fa-4daa-55e7-8019-d302301d54cd
+//# debugId=cb1e2010-bf9f-5eb9-a77d-70e31f5463ac