@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/store/paths.d.ts

@@ -25,7 +25,7 @@ export declare function getTypeDirPath(pmRoot: string, type: ItemType, typeToFol
 export declare function getItemPath(pmRoot: string, type: ItemType, id: string, itemFormat?: ItemFormat, typeToFolder?: Record<string, string>): string;
 /** Implements get item format from path for the public runtime surface of this module. */
 export declare function getItemFormatFromPath(itemPath: string): ItemFormat | null;
-/** Implements get history path for the public runtime surface of this module. */
+/** Constrain stream identifiers to a single portable filename before any read or rewrite. */
 export declare function getHistoryPath(pmRoot: string, id: string): string;
 /** Implements get lock path for the public runtime surface of this module. */
 export declare function getLockPath(pmRoot: string, id: string): string;

package/dist/core/store/paths.js

@@ -1,215 +1,2 @@
-/**
- * @module core/store/paths
- *
- * Reads and writes tracker storage with format-aware helpers for Paths.
- */
-
-!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]="c155ccd1-cf4c-57fd-9d0e-5274eb29a764")}catch(e){}}();
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { PM_DIRNAME, SETTINGS_FILENAME, TYPE_TO_FOLDER, } from "../shared/constants.js";
-import { toDefaultFolder } from "../item/type-registry.js";
-/** Public contract for item file extension by format, shared by SDK and presentation-layer consumers. */
-export const ITEM_FILE_EXTENSION_BY_FORMAT = {
-    json_markdown: ".md",
-    toon: ".toon",
-};
-const ITEM_FORMAT_BY_EXTENSION = {
-    ".md": "json_markdown",
-    ".toon": "toon",
-};
-const NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES = new Set([
-    ".git",
-    "coverage",
-    "dist",
-    "node_modules",
-]);
-/** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */
-export const ITEM_FILE_EXTENSIONS = [".md", ".toon"];
-function pathExists(pathValue) {
-    try {
-        statSync(pathValue);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// Adopting a bare <dir>/settings.json during implicit ancestor discovery must
-// not let an unrelated tool's settings.json hijack tracker resolution (and
-// receive pm writes), so root-layout candidates need a pm-specific marker.
-// `pm init` always writes both markers; explicit --path/PM_PATH targets skip
-// this check because they carry user intent.
-function isPmSettingsFile(settingsPath) {
-    try {
-        const parsed = JSON.parse(readFileSync(settingsPath, "utf8"));
-        if (typeof parsed !== "object" ||
-            parsed === null ||
-            Array.isArray(parsed)) {
-            return false;
-        }
-        return "id_prefix" in parsed || "item_format" in parsed;
-    }
-    catch {
-        return false;
-    }
-}
-function discoverPmRootFromAncestors(cwd) {
-    let current = path.resolve(cwd);
-    while (true) {
-        const candidateRoot = path.join(current, PM_DIRNAME);
-        const candidateSettingsPath = path.join(candidateRoot, SETTINGS_FILENAME);
-        if (pathExists(candidateSettingsPath)) {
-            return candidateRoot;
-        }
-        // Root-layout trackers (`pm init <dir>` writes settings.json directly into
-        // <dir>) must be discoverable too; otherwise implicit invocations — and the
-        // pm_root handed to extensions — fall back to a non-existent
-        // <cwd>/.agents/pm (GH-495).
-        const rootLayoutSettingsPath = path.join(current, SETTINGS_FILENAME);
-        if (pathExists(rootLayoutSettingsPath) &&
-            isPmSettingsFile(rootLayoutSettingsPath)) {
-            return current;
-        }
-        const parent = path.dirname(current);
-        if (parent === current) {
-            return undefined;
-        }
-        current = parent;
-    }
-}
-/** Resolve the tracker owned by the current workspace without honoring explicit CLI or PM_PATH overrides. */
-export function resolveImplicitPmRoot(cwd) {
-    return discoverPmRootFromAncestors(cwd) ?? path.resolve(cwd, PM_DIRNAME);
-}
-/** Find a directly nested custom tracker root so recovery guidance can preserve existing data instead of recommending a second initialization. */
-export function discoverNearbyPmRoot(cwd, excludedRoot) {
-    const normalizedExcluded = excludedRoot
-        ? path.resolve(excludedRoot)
-        : undefined;
-    try {
-        return readdirSync(path.resolve(cwd), { withFileTypes: true })
-            .filter((entry) => entry.isDirectory() &&
-            !NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES.has(entry.name))
-            .map((entry) => path.join(path.resolve(cwd), entry.name))
-            .filter((candidate) => candidate !== normalizedExcluded)
-            .filter((candidate) => pathExists(getSettingsPath(candidate)))
-            .filter((candidate) => isPmSettingsFile(getSettingsPath(candidate)))
-            .sort((left, right) => left.localeCompare(right))[0];
-    }
-    catch {
-        return undefined;
-    }
-}
-/** Implements resolve pm root for the public runtime surface of this module. */
-export function resolvePmRoot(cwd, cliPath) {
-    const envPath = process.env.PM_PATH;
-    const explicitPath = cliPath?.trim() || envPath?.trim();
-    if (explicitPath) {
-        const resolved = path.resolve(cwd, explicitPath);
-        // When an explicit --path/PM_PATH points at a project root that contains an
-        // initialized `.agents/pm`, resolve into it. Without this, an agent passing
-        // the directory where it ran `pm init` (which creates `<dir>/.agents/pm`)
-        // hits a hard "tracker not initialized" dead-end, while cwd discovery walks
-        // up to find the same `.agents/pm`. We only redirect when the path itself is
-        // not already a tracker root, so `pm init --path <dir>` (which writes
-        // `<dir>/settings.json` directly) and existing tracker roots keep working.
-        if (!pathExists(getSettingsPath(resolved))) {
-            const nestedRoot = path.join(resolved, PM_DIRNAME);
-            if (pathExists(getSettingsPath(nestedRoot))) {
-                return nestedRoot;
-            }
-        }
-        return resolved;
-    }
-    return resolveImplicitPmRoot(cwd);
-}
-/** Resolve the project workspace that owns a tracker root. */
-export function resolveWorkspaceRoot(pmRoot) {
-    const normalizedRoot = path.resolve(pmRoot);
-    const parent = path.dirname(normalizedRoot);
-    return path.basename(normalizedRoot) === "pm" &&
-        path.basename(parent) === ".agents"
-        ? path.dirname(parent)
-        : normalizedRoot;
-}
-/** Implements resolve global pm root for the public runtime surface of this module. */
-export function resolveGlobalPmRoot(cwd) {
-    const envPath = process.env.PM_GLOBAL_PATH?.trim();
-    const selected = envPath && envPath.length > 0
-        ? envPath
-        : path.join(os.homedir(), ".pm-cli");
-    return path.resolve(cwd, selected);
-}
-/** Implements get settings path for the public runtime surface of this module. */
-export function getSettingsPath(pmRoot) {
-    return path.join(pmRoot, SETTINGS_FILENAME);
-}
-/** Implements get type dir path for the public runtime surface of this module. */
-export function getTypeDirPath(pmRoot, type, typeToFolder = TYPE_TO_FOLDER) {
-    const folder = typeToFolder[type] ?? toDefaultFolder(type);
-    return path.join(pmRoot, folder);
-}
-/** Implements get item path for the public runtime surface of this module. */
-export function getItemPath(pmRoot, type, id, itemFormat = "toon", typeToFolder = TYPE_TO_FOLDER) {
-    return path.join(getTypeDirPath(pmRoot, type, typeToFolder), `${id}${ITEM_FILE_EXTENSION_BY_FORMAT[itemFormat]}`);
-}
-/** Implements get item format from path for the public runtime surface of this module. */
-export function getItemFormatFromPath(itemPath) {
-    const normalizedItemPath = itemPath.replaceAll("\\", "/");
-    const extension = path.posix
-        .extname(normalizedItemPath)
-        .toLowerCase();
-    return ITEM_FORMAT_BY_EXTENSION[extension] ?? null;
-}
-/** Implements get history path for the public runtime surface of this module. */
-export function getHistoryPath(pmRoot, id) {
-    return path.join(pmRoot, "history", `${id}.jsonl`);
-}
-/** Implements get lock path for the public runtime surface of this module. */
-export function getLockPath(pmRoot, id) {
-    return path.join(pmRoot, "locks", `${id}.lock`);
-}
-/** Implements get runtime path for the public runtime surface of this module. */
-export function getRuntimePath(pmRoot) {
-    return path.join(pmRoot, "runtime");
-}
-/** Implements get test runs path for the public runtime surface of this module. */
-export function getTestRunsPath(pmRoot) {
-    return path.join(getRuntimePath(pmRoot), "test-runs");
-}
-/** Implements get test runs records path for the public runtime surface of this module. */
-export function getTestRunsRecordsPath(pmRoot) {
-    return path.join(getTestRunsPath(pmRoot), "runs");
-}
-/** Implements get test run record path for the public runtime surface of this module. */
-export function getTestRunRecordPath(pmRoot, runId) {
-    return path.join(getTestRunsRecordsPath(pmRoot), `${runId}.json`);
-}
-/** Implements get test runs stdout path for the public runtime surface of this module. */
-export function getTestRunsStdoutPath(pmRoot) {
-    return path.join(getTestRunsPath(pmRoot), "stdout");
-}
-/** Implements get test runs stderr path for the public runtime surface of this module. */
-export function getTestRunsStderrPath(pmRoot) {
-    return path.join(getTestRunsPath(pmRoot), "stderr");
-}
-/** Implements get test run stdout path for the public runtime surface of this module. */
-export function getTestRunStdoutPath(pmRoot, runId) {
-    return path.join(getTestRunsStdoutPath(pmRoot), `${runId}.log`);
-}
-/** Implements get test run stderr path for the public runtime surface of this module. */
-export function getTestRunStderrPath(pmRoot, runId) {
-    return path.join(getTestRunsStderrPath(pmRoot), `${runId}.log`);
-}
-/** Implements get test runs results path for the public runtime surface of this module. */
-export function getTestRunsResultsPath(pmRoot) {
-    return path.join(getTestRunsPath(pmRoot), "results");
-}
-/** Implements get test run result path for the public runtime surface of this module. */
-export function getTestRunResultPath(pmRoot, runId) {
-    return path.join(getTestRunsResultsPath(pmRoot), `${runId}.json`);
-}
+!(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]="124443e3-a20b-5fd6-a1d9-e4a09b17dc4a")}catch(e2){}})();import{readFileSync,readdirSync,statSync}from"node:fs";import os from"node:os";import path from"node:path";import{PM_DIRNAME,EXIT_CODE,SETTINGS_FILENAME,TYPE_TO_FOLDER}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{toDefaultFolder}from"../item/type-registry.js";const ITEM_FILE_EXTENSION_BY_FORMAT={json_markdown:".md",toon:".toon"};const ITEM_FORMAT_BY_EXTENSION={".md":"json_markdown",".toon":"toon"};const NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES=new Set([".git","coverage","dist","node_modules"]);const ITEM_FILE_EXTENSIONS=[".md",".toon"];function pathExists(pathValue){try{statSync(pathValue);return true}catch{return false}}function isPmSettingsFile(settingsPath){try{const parsed=JSON.parse(readFileSync(settingsPath,"utf8"));if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return false}return"id_prefix"in parsed||"item_format"in parsed}catch{return false}}function discoverPmRootFromAncestors(cwd){let current=path.resolve(cwd);while(true){const candidateRoot=path.join(current,PM_DIRNAME);const candidateSettingsPath=path.join(candidateRoot,SETTINGS_FILENAME);if(pathExists(candidateSettingsPath)){return candidateRoot}const rootLayoutSettingsPath=path.join(current,SETTINGS_FILENAME);if(pathExists(rootLayoutSettingsPath)&&isPmSettingsFile(rootLayoutSettingsPath)){return current}const parent=path.dirname(current);if(parent===current){return void 0}current=parent}}function resolveImplicitPmRoot(cwd){return discoverPmRootFromAncestors(cwd)??path.resolve(cwd,PM_DIRNAME)}function discoverNearbyPmRoot(cwd,excludedRoot){const normalizedExcluded=excludedRoot?path.resolve(excludedRoot):void 0;try{return readdirSync(path.resolve(cwd),{withFileTypes:true}).filter(entry=>entry.isDirectory()&&!NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES.has(entry.name)).map(entry=>path.join(path.resolve(cwd),entry.name)).filter(candidate=>candidate!==normalizedExcluded).filter(candidate=>pathExists(getSettingsPath(candidate))).filter(candidate=>isPmSettingsFile(getSettingsPath(candidate))).sort((left,right)=>left.localeCompare(right))[0]}catch{return void 0}}function resolvePmRoot(cwd,cliPath){const envPath=process.env.PM_PATH;const explicitPath=cliPath?.trim()||envPath?.trim();if(explicitPath){const resolved=path.resolve(cwd,explicitPath);if(!pathExists(getSettingsPath(resolved))){const nestedRoot=path.join(resolved,PM_DIRNAME);if(pathExists(getSettingsPath(nestedRoot))){return nestedRoot}}return resolved}return resolveImplicitPmRoot(cwd)}function resolveWorkspaceRoot(pmRoot){const normalizedRoot=path.resolve(pmRoot);const parent=path.dirname(normalizedRoot);return path.basename(normalizedRoot)==="pm"&&path.basename(parent)===".agents"?path.dirname(parent):normalizedRoot}function resolveGlobalPmRoot(cwd){const envPath=process.env.PM_GLOBAL_PATH?.trim();const selected=envPath&&envPath.length>0?envPath:path.join(os.homedir(),".pm-cli");return path.resolve(cwd,selected)}function getSettingsPath(pmRoot){return path.join(pmRoot,SETTINGS_FILENAME)}function getTypeDirPath(pmRoot,type,typeToFolder=TYPE_TO_FOLDER){const folder=typeToFolder[type]??toDefaultFolder(type);return path.join(pmRoot,folder)}function getItemPath(pmRoot,type,id,itemFormat="toon",typeToFolder=TYPE_TO_FOLDER){return path.join(getTypeDirPath(pmRoot,type,typeToFolder),`${id}${ITEM_FILE_EXTENSION_BY_FORMAT[itemFormat]}`)}function getItemFormatFromPath(itemPath){const normalizedItemPath=itemPath.replaceAll("\\","/");const extension=path.posix.extname(normalizedItemPath).toLowerCase();return ITEM_FORMAT_BY_EXTENSION[extension]??null}function getHistoryPath(pmRoot,id){if(!/^(?!\.{1,2}$)[^/\\:\0]+$/.test(id)){throw new PmCliError("Invalid history item id: expected a single filename.",EXIT_CODE.USAGE)}return path.join(pmRoot,"history",`${id}.jsonl`)}function getLockPath(pmRoot,id){return path.join(pmRoot,"locks",`${id}.lock`)}function getRuntimePath(pmRoot){return path.join(pmRoot,"runtime")}function getTestRunsPath(pmRoot){return path.join(getRuntimePath(pmRoot),"test-runs")}function getTestRunsRecordsPath(pmRoot){return path.join(getTestRunsPath(pmRoot),"runs")}function getTestRunRecordPath(pmRoot,runId){return path.join(getTestRunsRecordsPath(pmRoot),`${runId}.json`)}function getTestRunsStdoutPath(pmRoot){return path.join(getTestRunsPath(pmRoot),"stdout")}function getTestRunsStderrPath(pmRoot){return path.join(getTestRunsPath(pmRoot),"stderr")}function getTestRunStdoutPath(pmRoot,runId){return path.join(getTestRunsStdoutPath(pmRoot),`${runId}.log`)}function getTestRunStderrPath(pmRoot,runId){return path.join(getTestRunsStderrPath(pmRoot),`${runId}.log`)}function getTestRunsResultsPath(pmRoot){return path.join(getTestRunsPath(pmRoot),"results")}function getTestRunResultPath(pmRoot,runId){return path.join(getTestRunsResultsPath(pmRoot),`${runId}.json`)}export{ITEM_FILE_EXTENSIONS,ITEM_FILE_EXTENSION_BY_FORMAT,discoverNearbyPmRoot,getHistoryPath,getItemFormatFromPath,getItemPath,getLockPath,getRuntimePath,getSettingsPath,getTestRunRecordPath,getTestRunResultPath,getTestRunStderrPath,getTestRunStdoutPath,getTestRunsPath,getTestRunsRecordsPath,getTestRunsResultsPath,getTestRunsStderrPath,getTestRunsStdoutPath,getTypeDirPath,resolveGlobalPmRoot,resolveImplicitPmRoot,resolvePmRoot,resolveWorkspaceRoot};
 //# sourceMappingURL=paths.js.map
-//# debugId=c155ccd1-cf4c-57fd-9d0e-5274eb29a764

package/dist/core/store/settings-read-cache.js

@@ -1,86 +1,2 @@
-/**
- * @module core/store/settings-read-cache
- *
- * Reads and writes tracker storage with format-aware helpers for Settings Read Cache.
- */
-
-!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]="60da76ea-0bd3-56a9-a2bc-d88ba76e1013")}catch(e){}}();
-import { stat } from "node:fs/promises";
-const settingsReadCacheByRoot = new Map();
-function normalizeTrackedPaths(paths) {
-    return [
-        ...new Set(paths
-            .map((pathValue) => pathValue.trim())
-            .filter((pathValue) => pathValue.length > 0)),
-    ].sort((left, right) => left.localeCompare(right));
-}
-async function readPathSignature(targetPath) {
-    try {
-        const targetStats = await stat(targetPath);
-        return {
-            path: targetPath,
-            mtime_ms: targetStats.mtimeMs,
-            size: targetStats.size,
-        };
-    }
-    catch {
-        return {
-            path: targetPath,
-            mtime_ms: null,
-            size: null,
-        };
-    }
-}
-/** Implements collect settings read cache signatures for the public runtime surface of this module. */
-export async function collectSettingsReadCacheSignatures(paths) {
-    const normalizedPaths = normalizeTrackedPaths(paths);
-    const signatures = await Promise.all(normalizedPaths.map((targetPath) => readPathSignature(targetPath)));
-    signatures.sort((left, right) => left.path.localeCompare(right.path));
-    return signatures;
-}
-/** Implements settings read cache signatures equal for the public runtime surface of this module. */
-export function settingsReadCacheSignaturesEqual(left, right) {
-    if (left.length !== right.length) {
-        return false;
-    }
-    for (let index = 0; index < left.length; index += 1) {
-        const leftEntry = left[index];
-        const rightEntry = right[index];
-        if (leftEntry.path !== rightEntry.path ||
-            leftEntry.mtime_ms !== rightEntry.mtime_ms ||
-            leftEntry.size !== rightEntry.size) {
-            return false;
-        }
-    }
-    return true;
-}
-/** Implements get settings read cache entry for the public runtime surface of this module. */
-export function getSettingsReadCacheEntry(pmRoot) {
-    return settingsReadCacheByRoot.get(pmRoot);
-}
-/** Implements set settings read cache entry for the public runtime surface of this module. */
-export function setSettingsReadCacheEntry(pmRoot, entry) {
-    const normalizedTrackedPaths = normalizeTrackedPaths(entry.tracked_paths);
-    const normalizedSignatures = [...entry.signatures]
-        .map((signature) => ({
-        path: signature.path,
-        mtime_ms: signature.mtime_ms,
-        size: signature.size,
-    }))
-        .sort((left, right) => left.path.localeCompare(right.path));
-    settingsReadCacheByRoot.set(pmRoot, {
-        tracked_paths: normalizedTrackedPaths,
-        signatures: normalizedSignatures,
-        value: entry.value,
-    });
-}
-/** Implements clear settings read cache for the public runtime surface of this module. */
-export function clearSettingsReadCache(pmRoot) {
-    if (pmRoot) {
-        settingsReadCacheByRoot.delete(pmRoot);
-        return;
-    }
-    settingsReadCacheByRoot.clear();
-}
+!(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]="7c23ef10-ea7a-5680-8850-822e7d0c07a6")}catch(e2){}})();import{stat}from"node:fs/promises";const settingsReadCacheByRoot=new Map;function normalizeTrackedPaths(paths){return[...new Set(paths.map(pathValue=>pathValue.trim()).filter(pathValue=>pathValue.length>0))].sort((left,right)=>left.localeCompare(right))}async function readPathSignature(targetPath){try{const targetStats=await stat(targetPath);return{path:targetPath,mtime_ms:targetStats.mtimeMs,size:targetStats.size}}catch{return{path:targetPath,mtime_ms:null,size:null}}}async function collectSettingsReadCacheSignatures(paths){const normalizedPaths=normalizeTrackedPaths(paths);const signatures=await Promise.all(normalizedPaths.map(targetPath=>readPathSignature(targetPath)));signatures.sort((left,right)=>left.path.localeCompare(right.path));return signatures}function settingsReadCacheSignaturesEqual(left,right){if(left.length!==right.length){return false}for(let index=0;index<left.length;index+=1){const leftEntry=left[index];const rightEntry=right[index];if(leftEntry.path!==rightEntry.path||leftEntry.mtime_ms!==rightEntry.mtime_ms||leftEntry.size!==rightEntry.size){return false}}return true}function getSettingsReadCacheEntry(pmRoot){return settingsReadCacheByRoot.get(pmRoot)}function setSettingsReadCacheEntry(pmRoot,entry){const normalizedTrackedPaths=normalizeTrackedPaths(entry.tracked_paths);const normalizedSignatures=[...entry.signatures].map(signature=>({path:signature.path,mtime_ms:signature.mtime_ms,size:signature.size})).sort((left,right)=>left.path.localeCompare(right.path));settingsReadCacheByRoot.set(pmRoot,{tracked_paths:normalizedTrackedPaths,signatures:normalizedSignatures,value:entry.value})}function clearSettingsReadCache(pmRoot){if(pmRoot){settingsReadCacheByRoot.delete(pmRoot);return}settingsReadCacheByRoot.clear()}export{clearSettingsReadCache,collectSettingsReadCacheSignatures,getSettingsReadCacheEntry,setSettingsReadCacheEntry,settingsReadCacheSignaturesEqual};
 //# sourceMappingURL=settings-read-cache.js.map
-//# debugId=60da76ea-0bd3-56a9-a2bc-d88ba76e1013

package/dist/core/store/settings-validator.d.ts

@@ -123,6 +123,7 @@ export interface ParsedSettings {
         embedding_timeout_ms?: number;
         scanner_max_batch_retries: number;
         provider?: string;
+        default_mode?: "auto" | "keyword" | "semantic" | "hybrid";
         corpus_fields?: string[];
         mutation_refresh_policy?: "cache_only" | "semantic_configured" | "semantic_auto";
         query_expansion?: {