@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/init-agent-guidance.d.ts

@@ -3,114 +3,114 @@ import type { PmSettings } from "../types/index.js";
 /** Restricts init agent guidance mode values accepted by command, SDK, and storage contracts. */
 export type InitAgentGuidanceMode = "ask" | "add" | "skip" | "status";
 /** Supported values accepted by the init agent guidance mode contract. */
-export declare const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[];
+export declare const INIT_AGENT_GUIDANCE_MODE_VALUES:InitAgentGuidanceMode[];
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-toPortableRelativePath: typeof toPortableRelativePath;
-ensureTrailingNewline: typeof ensureTrailingNewline;
-detectLineEnding: typeof detectLineEnding;
-findGuidanceBlockRange: typeof findGuidanceBlockRange;
-buildAgentGuidanceBlock: typeof buildAgentGuidanceBlock;
-upsertAgentGuidanceBlock: typeof upsertAgentGuidanceBlock;
-resolveProjectRoot: typeof resolveProjectRoot;
-resolveTargetGuidancePath: typeof resolveTargetGuidancePath;
-parsePromptChoice: typeof parsePromptChoice;
-pushUnique: typeof pushUnique;
-promptForGuidanceWrite: typeof promptForGuidanceWrite;
-normalizeAgentGuidanceState: typeof normalizeAgentGuidanceState;
-applyAgentGuidanceState: typeof applyAgentGuidanceState;
-writeGuidanceFile: typeof writeGuidanceFile;
-setAgentGuidanceReadlineFactoryForTests: typeof setAgentGuidanceReadlineFactoryForTests;
+export declare const _testOnly:{
+toPortableRelativePath:typeof toPortableRelativePath;
+ensureTrailingNewline:typeof ensureTrailingNewline;
+detectLineEnding:typeof detectLineEnding;
+findGuidanceBlockRange:typeof findGuidanceBlockRange;
+buildAgentGuidanceBlock:typeof buildAgentGuidanceBlock;
+upsertAgentGuidanceBlock:typeof upsertAgentGuidanceBlock;
+resolveProjectRoot:typeof resolveProjectRoot;
+resolveTargetGuidancePath:typeof resolveTargetGuidancePath;
+parsePromptChoice:typeof parsePromptChoice;
+pushUnique:typeof pushUnique;
+promptForGuidanceWrite:typeof promptForGuidanceWrite;
+normalizeAgentGuidanceState:typeof normalizeAgentGuidanceState;
+applyAgentGuidanceState:typeof applyAgentGuidanceState;
+writeGuidanceFile:typeof writeGuidanceFile;
+setAgentGuidanceReadlineFactoryForTests:typeof setAgentGuidanceReadlineFactoryForTests;
 };
 type AgentGuidanceReadlineInterface = ReturnType<typeof readline.createInterface>;
-declare function setAgentGuidanceReadlineFactoryForTests(factory: (() => AgentGuidanceReadlineInterface) | undefined): void;
+declare function setAgentGuidanceReadlineFactoryForTests(factory:(() => AgentGuidanceReadlineInterface) | undefined):void;
 interface AgentGuidanceFileScan {
-file_path: string;
-exists: boolean;
-has_guidance: boolean;
-has_marker: boolean;
-outdated?: boolean;
+file_path:string;
+exists:boolean;
+has_guidance:boolean;
+has_marker:boolean;
+outdated?:boolean;
 }
 interface AgentGuidanceBlockRange {
-start_index: number;
-end_index: number;
+start_index:number;
+end_index:number;
 }
 /** Documents the init agent guidance summary payload exchanged by command, SDK, and package integrations. */
 export interface InitAgentGuidanceSummary {
 /** Value that configures or reports mode for this contract. */
-mode: InitAgentGuidanceMode;
+mode:InitAgentGuidanceMode;
 /** Value that configures or reports present for this contract. */
-present: boolean;
+present:boolean;
 /** Value that configures or reports prompted for this contract. */
-prompted: boolean;
+prompted:boolean;
 /** Value that configures or reports applied for this contract. */
-applied: boolean;
+applied:boolean;
 /** Value that configures or reports skipped for this contract. */
-skipped: boolean;
+skipped:boolean;
 /** Value that configures or reports declined for this contract. */
-declined: boolean;
+declined:boolean;
 /** Value that configures or reports prompt completed for this contract. */
-prompt_completed: boolean;
+prompt_completed:boolean;
 /** Value that configures or reports template version for this contract. */
-template_version: number;
+template_version:number;
 /** Value that configures or reports target file for this contract. */
-target_file: string;
+target_file:string;
 /** Value that configures or reports checked files for this contract. */
-checked_files: string[];
+checked_files:string[];
 /** Value that configures or reports files with guidance for this contract. */
-files_with_guidance: string[];
+files_with_guidance:string[];
 /** Value that configures or reports missing files for this contract. */
-missing_files: string[];
+missing_files:string[];
 }
 /** Documents the run init agent guidance options payload exchanged by command, SDK, and package integrations. */
 export interface RunInitAgentGuidanceOptions {
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Value that configures or reports cwd for this contract. */
-cwd: string;
+cwd:string;
 /** Value that configures or reports mode for this contract. */
-mode: InitAgentGuidanceMode;
+mode:InitAgentGuidanceMode;
 /** Value that configures or reports interactive for this contract. */
-interactive: boolean;
+interactive:boolean;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 }
 /** Documents the run init agent guidance result payload exchanged by command, SDK, and package integrations. */
 export interface RunInitAgentGuidanceResult {
 /** Value that configures or reports summary for this contract. */
-summary: InitAgentGuidanceSummary;
+summary:InitAgentGuidanceSummary;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports next steps for this contract. */
-next_steps: string[];
+next_steps:string[];
 /** Value that configures or reports settings changed for this contract. */
-settings_changed: boolean;
+settings_changed:boolean;
 }
-declare function toPortableRelativePath(projectRoot: string, targetPath: string): string;
-declare function ensureTrailingNewline(value: string): string;
-declare function detectLineEnding(value: string): "\n" | "\r\n";
-declare function findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null;
-declare function buildAgentGuidanceBlock(lineEnding: "\n" | "\r\n", projectTestCommand?: string): string;
-declare function upsertAgentGuidanceBlock(existingContent: string, projectTestCommand?: string): {
-next_content: string;
-changed: boolean;
+declare function toPortableRelativePath(projectRoot:string,targetPath:string):string;
+declare function ensureTrailingNewline(value:string):string;
+declare function detectLineEnding(value:string):"\n" | "\r\n";
+declare function findGuidanceBlockRange(content:string):AgentGuidanceBlockRange | null;
+declare function buildAgentGuidanceBlock(lineEnding:"\n" | "\r\n",projectTestCommand?:string):string;
+declare function upsertAgentGuidanceBlock(existingContent:string,projectTestCommand?:string):{
+next_content:string;
+changed:boolean;
 };
 /** Resolve an executable linked-test command from a target repository's own files. */
-export declare function resolveProjectTestCommand(projectRoot: string): Promise<string>;
-declare function resolveProjectRoot(pmRoot: string, cwd: string): string;
-declare function resolveTargetGuidancePath(scans: AgentGuidanceFileScan[], projectRoot: string): string;
-declare function parsePromptChoice(answer: string, currentDefault: boolean): boolean;
-declare function promptForGuidanceWrite(targetRelativePath: string): Promise<boolean>;
-declare function normalizeAgentGuidanceState(settings: PmSettings): PmSettings["agent_guidance"];
-declare function pushUnique(target: string[], value: string): void;
-declare function applyAgentGuidanceState(settings: PmSettings, currentState: PmSettings["agent_guidance"]): {
-changed: boolean;
-state: PmSettings["agent_guidance"];
+export declare function resolveProjectTestCommand(projectRoot:string):Promise<string>;
+declare function resolveProjectRoot(pmRoot:string,cwd:string):string;
+declare function resolveTargetGuidancePath(scans:AgentGuidanceFileScan[],projectRoot:string):string;
+declare function parsePromptChoice(answer:string,currentDefault:boolean):boolean;
+declare function promptForGuidanceWrite(targetRelativePath:string):Promise<boolean>;
+declare function normalizeAgentGuidanceState(settings:PmSettings):PmSettings["agent_guidance"];
+declare function pushUnique(target:string[],value:string):void;
+declare function applyAgentGuidanceState(settings:PmSettings,currentState:PmSettings["agent_guidance"]):{
+changed:boolean;
+state:PmSettings["agent_guidance"];
 };
-declare function writeGuidanceFile(filePath: string, projectRoot?: string): Promise<{
-changed: boolean;
-warnings: string[];
+declare function writeGuidanceFile(filePath:string,projectRoot?:string):Promise<{
+changed:boolean;
+warnings:string[];
 }>;
 /** Inspect, offer or refresh managed guidance; preserve surrounding prose and return state for the caller's settings transaction. */
-export declare function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult>;
+export declare function runInitAgentGuidance(options:RunInitAgentGuidanceOptions):Promise<RunInitAgentGuidanceResult>;
 export {};

package/dist/sdk/init.d.ts

@@ -1,22 +1,22 @@
 import readline from "node:readline/promises";
 import { type TypePresetName } from "../core/schema/type-presets.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import type { GovernancePreset, PmSettings } from "../types/index.js";
+import type { GovernancePreset,PmSettings } from "../types/index.js";
 import { type ExtensionCommandResult } from "./extension.js";
-import { type InitAgentGuidanceMode, type InitAgentGuidanceSummary } from "./init-agent-guidance.js";
+import { type InitAgentGuidanceMode,type InitAgentGuidanceSummary } from "./init-agent-guidance.js";
 import { installMergeFence } from "./merge/install.js";
 /** Symbol key for the captured working directory of an in-process init call. */
-export declare const INIT_INVOCATION_CWD: unique symbol;
+export declare const INIT_INVOCATION_CWD:unique symbol;
 /** Documents the init installed packages summary payload exchanged by command, SDK, and package integrations. */
 export interface InitInstalledPackagesSummary {
 /** Value that configures or reports installed all for this contract. */
-installed_all: boolean;
+installed_all:boolean;
 /** Number of installed entries represented by this result. */
-installed_count: number;
+installed_count:number;
 /** Value that configures or reports packages for this contract. */
-packages: Array<{
-alias: string;
-ok: boolean;
+packages:Array<{
+alias:string;
+ok:boolean;
 }>;
 }
 /** Restricts init type preset name values accepted by command, SDK, and storage contracts. */
@@ -24,202 +24,202 @@ export type InitTypePresetName = TypePresetName;
 /** Documents the init registered type preset summary payload exchanged by command, SDK, and package integrations. */
 export interface InitRegisteredTypePresetSummary {
 /** Value that configures or reports name for this contract. */
-name: InitTypePresetName;
+name:InitTypePresetName;
 /** Value that configures or reports registered for this contract. */
-registered: string[];
+registered:string[];
 /** Value that configures or reports updated for this contract. */
-updated: string[];
+updated:string[];
 /** Value that configures or reports file for this contract. */
-file: string;
+file:string;
 }
 /** Documents the init agent-guidance summary plus generated next-step hints returned by init. */
 export type InitAgentGuidanceResult = InitAgentGuidanceSummary & {
-next_steps: string[];
+next_steps:string[];
 };
 /** Describes how init resolved the tracker and optional workspace target. */
 export interface InitTargetResolution {
 /** Value that configures or reports mode for this contract. */
-mode: "workspace-discovery" | "tracker-path" | "workspace-path";
+mode:"workspace-discovery" | "tracker-path" | "workspace-path";
 /** Value that configures or reports tracker root for this contract. */
-tracker_root: string;
+tracker_root:string;
 /** Value that configures or reports workspace root for this contract. */
-workspace_root?: string;
+workspace_root?:string;
 /** How workspace discovery related the invocation directory to the selected tracker. */
-discovery?: "current" | "ancestor";
+discovery?:"current" | "ancestor";
 /** Directory from which workspace discovery was requested. */
-requested_cwd?: string;
+requested_cwd?:string;
 /** Explicit tracker root that creates a new workspace in the invocation directory. */
-suggested_current_tracker_root?: string;
+suggested_current_tracker_root?:string;
 }
 /** Documents the init result payload exchanged by command, SDK, and package integrations. */
 export interface InitResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports target for this contract. */
-target: InitTargetResolution;
+target:InitTargetResolution;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports created dirs for this contract. */
-created_dirs: string[];
+created_dirs:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports governance preset for this contract. */
-governance_preset: GovernancePreset;
+governance_preset:GovernancePreset;
 /** Value that configures or reports wizard used for this contract. */
-wizard_used: boolean;
+wizard_used:boolean;
 /** Value that configures or reports registered type preset for this contract. */
-registered_type_preset?: InitRegisteredTypePresetSummary;
+registered_type_preset?:InitRegisteredTypePresetSummary;
 /** Value that configures or reports installed packages for this contract. */
-installed_packages?: InitInstalledPackagesSummary;
+installed_packages?:InitInstalledPackagesSummary;
 /** Value that configures or reports next steps for this contract. */
-next_steps: string[];
+next_steps:string[];
 /** Value that configures or reports agent guidance for this contract. */
-agent_guidance: InitAgentGuidanceResult;
+agent_guidance:InitAgentGuidanceResult;
 }
 /** Documents the init command options payload exchanged by command, SDK, and package integrations. */
 export interface InitCommandOptions {
 /** Item-id prefix supplied through the flag-oriented SDK/CLI input surface. */
-idPrefix?: string;
+idPrefix?:string;
 /** Value that configures or reports preset for this contract. */
-preset?: string;
+preset?:string;
 /** Value that configures or reports defaults for this contract. */
-defaults?: boolean;
+defaults?:boolean;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Value that configures or reports with packages for this contract. */
-withPackages?: boolean;
+withPackages?:boolean;
 /** Install the repository merge fence for a fresh Git-backed tracker. */
-mergeFence?: boolean;
+mergeFence?:boolean;
 /** Value that configures or reports agent guidance for this contract. */
-agentGuidance?: string;
+agentGuidance?:string;
 /** Value that configures or reports type preset for this contract. */
-typePreset?: string;
+typePreset?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 /** Value that configures or reports workspace for this contract. */
-workspace?: string;
+workspace?:string;
 }
 /** Concise projection of an InitResult for the default (toon) renderer. It keeps every piece of information that only init can surface — the resolved path, id prefix, governance preset, telemetry capture level, created-directory count, the full warnings list (including `already_exists:` markers), agent-guidance summary, and next steps — but replaces the verbose full settings tree (~190 lines) with a compact `settings` summary. Use --verbose for the full tree. */
 export interface InitConciseResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports target for this contract. */
-target: InitTargetResolution;
+target:InitTargetResolution;
 /** Value that configures or reports id prefix for this contract. */
-id_prefix: string;
+id_prefix:string;
 /** Value that configures or reports governance preset for this contract. */
-governance_preset: GovernancePreset;
+governance_preset:GovernancePreset;
 /** Value that configures or reports telemetry for this contract. */
-telemetry: {
-enabled: boolean;
-capture_level: string;
+telemetry:{
+enabled:boolean;
+capture_level:string;
 };
 /** Value that configures or reports output format for this contract. */
-output_format: string;
+output_format:string;
 /** Number of created dirs entries represented by this result. */
-created_dirs_count: number;
+created_dirs_count:number;
 /** Value that configures or reports created dirs for this contract. */
-created_dirs: string[];
+created_dirs:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports wizard used for this contract. */
-wizard_used: boolean;
+wizard_used:boolean;
 /** Value that configures or reports registered type preset for this contract. */
-registered_type_preset?: InitRegisteredTypePresetSummary;
+registered_type_preset?:InitRegisteredTypePresetSummary;
 /** Value that configures or reports installed packages for this contract. */
-installed_packages?: InitInstalledPackagesSummary;
+installed_packages?:InitInstalledPackagesSummary;
 /** Value that configures or reports next steps for this contract. */
-next_steps: string[];
+next_steps:string[];
 /** Value that configures or reports agent guidance for this contract. */
-agent_guidance: InitAgentGuidanceResult;
+agent_guidance:InitAgentGuidanceResult;
 /** Value that configures or reports hint for this contract. */
-hint: string;
+hint:string;
 }
 /** Minimal first-run display with actionable warnings and a full-result recovery hint. */
 export interface InitDisplayResult {
 /** Whether initialization succeeded. */
-ok: boolean;
+ok:boolean;
 /** Resolved tracker root, including explicitly selected or ancestor trackers. */
-path: string;
+path:string;
 /** Governance policy selected for this workspace. */
-governance_preset: GovernancePreset;
+governance_preset:GovernancePreset;
 /** Project telemetry consent and capture level. */
-telemetry: string;
+telemetry:string;
 /** Number of created directories and schema files. */
-created_count: number;
+created_count:number;
 /** Concrete first commands, scoped to the selected tracker. */
-next_steps: string[];
+next_steps:string[];
 /** Non-routine warnings that require attention. */
-warnings?: string;
+warnings?:string;
 /** How to retrieve the complete settings, setup details, and routine notices. */
-details: string;
+details:string;
 }
 /** Select a compact display without changing the full initialization result. */
-export declare function summarizeInitResult(result: InitResult, display: true): InitDisplayResult;
+export declare function summarizeInitResult(result:InitResult,display:true):InitDisplayResult;
 /** Preserve existing calls and utility-type consumers through the final compatibility overload. */
-export declare function summarizeInitResult(result: InitResult): InitConciseResult;
+export declare function summarizeInitResult(result:InitResult):InitConciseResult;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-normalizeInitGovernancePreset: typeof normalizeInitGovernancePreset;
-normalizeInitTypePreset: typeof normalizeInitTypePreset;
-normalizeOptionalInitAuthor: typeof normalizeOptionalInitAuthor;
-normalizeInitAgentGuidanceMode: typeof normalizeInitAgentGuidanceMode;
-isPathLikeInitTarget: typeof isPathLikeInitTarget;
-resolveInitInvocation: typeof resolveInitInvocation;
-resolveInitPrefixInput: typeof resolveInitPrefixInput;
-parseYesNoChoice: typeof parseYesNoChoice;
-applyGovernancePreset: typeof applyGovernancePreset;
-runInitWizard: typeof runInitWizard;
-setInitReadlineFactoryForTests: typeof setInitReadlineFactoryForTests;
-summarizeInstalledPackages: typeof summarizeInstalledPackages;
-buildInitNextSteps: typeof buildInitNextSteps;
-registerInitTypePreset: typeof registerInitTypePreset;
-assertExplicitTrackerPathIsNotWorkspaceRoot: typeof assertExplicitTrackerPathIsNotWorkspaceRoot;
-isLikelyWorkspaceRoot: typeof isLikelyWorkspaceRoot;
-installInitMergeFence: typeof installInitMergeFence;
+export declare const _testOnly:{
+normalizeInitGovernancePreset:typeof normalizeInitGovernancePreset;
+normalizeInitTypePreset:typeof normalizeInitTypePreset;
+normalizeOptionalInitAuthor:typeof normalizeOptionalInitAuthor;
+normalizeInitAgentGuidanceMode:typeof normalizeInitAgentGuidanceMode;
+isPathLikeInitTarget:typeof isPathLikeInitTarget;
+resolveInitInvocation:typeof resolveInitInvocation;
+resolveInitPrefixInput:typeof resolveInitPrefixInput;
+parseYesNoChoice:typeof parseYesNoChoice;
+applyGovernancePreset:typeof applyGovernancePreset;
+runInitWizard:typeof runInitWizard;
+setInitReadlineFactoryForTests:typeof setInitReadlineFactoryForTests;
+summarizeInstalledPackages:typeof summarizeInstalledPackages;
+buildInitNextSteps:typeof buildInitNextSteps;
+registerInitTypePreset:typeof registerInitTypePreset;
+assertExplicitTrackerPathIsNotWorkspaceRoot:typeof assertExplicitTrackerPathIsNotWorkspaceRoot;
+isLikelyWorkspaceRoot:typeof isLikelyWorkspaceRoot;
+installInitMergeFence:typeof installInitMergeFence;
 };
 type InitReadlineInterface = ReturnType<typeof readline.createInterface>;
-declare function setInitReadlineFactoryForTests(factory: (() => InitReadlineInterface) | undefined): void;
-type BuiltinGovernancePreset = Exclude<GovernancePreset, "custom">;
-declare function normalizeInitGovernancePreset(rawValue: string | undefined): BuiltinGovernancePreset | undefined;
-declare function normalizeInitTypePreset(rawValue: string | undefined): InitTypePresetName | undefined;
-declare function normalizeOptionalInitAuthor(rawValue: string | undefined): string | undefined;
-declare function isPathLikeInitTarget(rawValue: string | undefined): boolean;
-declare function resolveInitInvocation(cwd: string, global: GlobalOptions, prefixArg: string | undefined, workspaceArg?: string): {
-pmRoot: string;
-prefixArg: string | undefined;
-target: InitTargetResolution;
+declare function setInitReadlineFactoryForTests(factory:(() => InitReadlineInterface) | undefined):void;
+type BuiltinGovernancePreset = Exclude<GovernancePreset,"custom">;
+declare function normalizeInitGovernancePreset(rawValue:string | undefined):BuiltinGovernancePreset | undefined;
+declare function normalizeInitTypePreset(rawValue:string | undefined):InitTypePresetName | undefined;
+declare function normalizeOptionalInitAuthor(rawValue:string | undefined):string | undefined;
+declare function isPathLikeInitTarget(rawValue:string | undefined):boolean;
+declare function resolveInitInvocation(cwd:string,global:GlobalOptions,prefixArg:string | undefined,workspaceArg?:string):{
+pmRoot:string;
+prefixArg:string | undefined;
+target:InitTargetResolution;
 };
 /** Resolves the optional positional and flag-oriented id-prefix inputs, accepting equivalent normalized spellings and rejecting ambiguous conflicts. */
-declare function resolveInitPrefixInput(positionalPrefix: string | undefined, flaggedPrefix: string | undefined): string | undefined;
-declare function normalizeInitAgentGuidanceMode(rawValue: string | undefined): InitAgentGuidanceMode;
-declare function parseYesNoChoice(answer: string, currentDefault: boolean): boolean;
-declare function applyGovernancePreset(settings: PmSettings, preset: BuiltinGovernancePreset): void;
-declare function summarizeInstalledPackages(result: ExtensionCommandResult): InitInstalledPackagesSummary;
-declare function registerInitTypePreset(pmRoot: string, settings: PmSettings, preset: InitTypePresetName): Promise<InitRegisteredTypePresetSummary>;
-declare function isLikelyWorkspaceRoot(candidate: string): Promise<boolean>;
-declare function assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot: string, explicitTrackerTarget: boolean, force: boolean): Promise<void>;
-declare function runInitWizard(initialPrefix: string, telemetryDefault: boolean): Promise<{
-prefix: string;
-preset: BuiltinGovernancePreset;
-telemetry_enabled: boolean;
+declare function resolveInitPrefixInput(positionalPrefix:string | undefined,flaggedPrefix:string | undefined):string | undefined;
+declare function normalizeInitAgentGuidanceMode(rawValue:string | undefined):InitAgentGuidanceMode;
+declare function parseYesNoChoice(answer:string,currentDefault:boolean):boolean;
+declare function applyGovernancePreset(settings:PmSettings,preset:BuiltinGovernancePreset):void;
+declare function summarizeInstalledPackages(result:ExtensionCommandResult):InitInstalledPackagesSummary;
+declare function registerInitTypePreset(pmRoot:string,settings:PmSettings,preset:InitTypePresetName):Promise<InitRegisteredTypePresetSummary>;
+declare function isLikelyWorkspaceRoot(candidate:string):Promise<boolean>;
+declare function assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot:string,explicitTrackerTarget:boolean,force:boolean):Promise<void>;
+declare function runInitWizard(initialPrefix:string,telemetryDefault:boolean):Promise<{
+prefix:string;
+preset:BuiltinGovernancePreset;
+telemetry_enabled:boolean;
 }>;
-declare function buildInitNextSteps(params: {
-installBundledPackages: boolean;
-registeredTypePreset: InitRegisteredTypePresetSummary | undefined;
-agentGuidanceNextSteps: string[];
-target: InitTargetResolution;
-}): string[];
+declare function buildInitNextSteps(params:{
+installBundledPackages:boolean;
+registeredTypePreset:InitRegisteredTypePresetSummary | undefined;
+agentGuidanceNextSteps:string[];
+target:InitTargetResolution;
+}):string[];
 /**
  * Install the fresh-trackers merge fence without making an otherwise
  * successful initialization irrecoverable when Git configuration is
  * temporarily unavailable.
  */
-declare function installInitMergeFence(pmRoot: string, gitWorkspaceRoot: string | null, warnings: string[], install?: typeof installMergeFence): Promise<void>;
+declare function installInitMergeFence(pmRoot:string,gitWorkspaceRoot:string | null,warnings:string[],install?:typeof installMergeFence):Promise<void>;
 /** Implements run init for the public runtime surface of this module. */
-export declare function runInit(prefixArg: string | undefined, global: GlobalOptions, options?: InitCommandOptions): Promise<InitResult>;
+export declare function runInit(prefixArg:string | undefined,global:GlobalOptions,options?:InitCommandOptions):Promise<InitResult>;
 export {};

package/dist/sdk/invocation-author.d.ts

@@ -1,2 +1,2 @@
 /** Apply an optional author override and return an idempotent environment restorer. */
-export declare function applyInvocationAuthorOverride(author: string | undefined): () => void;
+export declare function applyInvocationAuthorOverride(author:string | undefined):() => void;

package/dist/sdk/item-children.d.ts

@@ -7,39 +7,39 @@ export declare const DEFAULT_CHILD_SAMPLE_LIMIT = 20;
 /** Stable compact child row embedded in a parent read. */
 export interface ChildRollupSample {
 /** Stable child identifier. */
-id: string;
+id:string;
 /** Human-readable child title. */
-title: string;
+title:string;
 /** Schema type of the child item. */
-type: string;
+type:string;
 /** Current lifecycle status of the child item. */
-status: string;
+status:string;
 /** Current priority of the child item. */
-priority: number;
+priority:number;
 }
 /** Bounded direct-child summary shared across SDK and presentation surfaces. */
 export interface ChildRollupContext {
 /** Total direct children discovered. */
-count: number;
+count:number;
 /** Direct children whose statuses are non-terminal. */
-active: number;
+active:number;
 /** Counts grouped by normalized lifecycle status. */
-by_status: Record<string, number>;
+by_status:Record<string,number>;
 /** Deterministic id-sorted inline sample. */
-sample: ChildRollupSample[];
+sample:ChildRollupSample[];
 /** Configured maximum sample size. */
-sample_limit: number;
+sample_limit:number;
 /** Whether additional children exist beyond the inline sample. */
-truncated: boolean;
+truncated:boolean;
 /** Offset for the next page, or null when the sample is complete. */
-next_offset: number | null;
+next_offset:number | null;
 /** Token-efficient CLI continuation command, or null when complete. */
-continuation: string | null;
+continuation:string | null;
 /** Number of corpus rows inspected to produce this projection. */
-scanned: number;
+scanned:number;
 }
 /**
  * Build a type-agnostic child rollup from indexed or source metadata. Input is
  * capped at one million rows to keep custom-host behavior explicitly bounded.
  */
-export declare function buildItemChildrenRollup(parentId: string, corpus: Iterable<ItemMetadata>, statusRegistry: RuntimeStatusRegistry, sampleLimit?: number): ChildRollupContext;
+export declare function buildItemChildrenRollup(parentId:string,corpus:Iterable<ItemMetadata>,statusRegistry:RuntimeStatusRegistry,sampleLimit?:number):ChildRollupContext;

package/dist/sdk/item-metadata-index.d.ts

@@ -8,5 +8,5 @@
  * must surface warning tokens returned by the refresh operation, including
  * invalid-path and refresh-failure diagnostics.
  */
-export { acquireItemMetadataDerivedIndexLock, DEFAULT_DERIVED_INDEX_MINIMUM_ITEMS, readItemMetadataDerivedIndexState, refreshItemMetadataDerivedIndex, type ItemMetadataDerivedIndexState, type ItemMetadataDerivedIndexMutation, type ItemMetadataDerivedIndexLockOptions, } from "../core/store/item-metadata-cache.js";
-export { queryItemMetadataIndex, queryLinkedFileMetadataIndex, querySimilarItemMetadataIndex, type IndexedLinkedFileMatch, type ItemMetadataIndexQuery, type ItemMetadataIndexQueryResult, type LinkedFileMetadataIndexResult, type SimilarItemMetadataIndexResult, } from "../core/store/item-metadata-query-index.js";
+export { acquireItemMetadataDerivedIndexLock,DEFAULT_DERIVED_INDEX_MINIMUM_ITEMS,readItemMetadataDerivedIndexState,refreshItemMetadataDerivedIndex,type ItemMetadataDerivedIndexState,type ItemMetadataDerivedIndexMutation,type ItemMetadataDerivedIndexLockOptions,} from "../core/store/item-metadata-cache.js";
+export { queryItemMetadataIndex,queryLinkedFileMetadataIndex,querySimilarItemMetadataIndex,type IndexedLinkedFileMatch,type ItemMetadataIndexQuery,type ItemMetadataIndexQueryResult,type LinkedFileMetadataIndexResult,type SimilarItemMetadataIndexResult,} from "../core/store/item-metadata-query-index.js";

package/dist/sdk/item-schedule.d.ts

@@ -4,23 +4,23 @@
  * Normalizes scheduling metadata into one stable read facet so scheduled item
  * types remain useful through generic SDK, CLI, MCP, JSON, and TOON reads.
  */
-import type { CalendarEvent, ItemMetadata, Reminder } from "../types/index.js";
+import type { CalendarEvent,ItemMetadata,Reminder } from "../types/index.js";
 /** Schedule projection attached to standard and deep item reads. */
 export interface ItemScheduleContext {
 /** Item deadline when present. */
-deadline: string | null;
+deadline:string | null;
 /** Earliest event start, convenient for single-event consumers. */
-start_at: string | null;
+start_at:string | null;
 /** End of the earliest event when present. */
-end_at: string | null;
+end_at:string | null;
 /** Location of the earliest event when present. */
-location: string | null;
+location:string | null;
 /** All configured reminders. */
-reminders: Reminder[];
+reminders:Reminder[];
 /** All configured events ordered by start timestamp. */
-events: CalendarEvent[];
+events:CalendarEvent[];
 }
 /** Return whether an item carries or semantically represents schedule data. */
-export declare function itemHasSchedule(item: ItemMetadata): boolean;
+export declare function itemHasSchedule(item:ItemMetadata):boolean;
 /** Build a deterministic schedule facet, or undefined for unscheduled items. */
-export declare function buildItemSchedule(item: ItemMetadata): ItemScheduleContext | undefined;
+export declare function buildItemSchedule(item:ItemMetadata):ItemScheduleContext | undefined;