@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/test/runs.d.ts

@@ -2,91 +2,91 @@ import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type BackgroundLogStream, type BackgroundTestRunKind, type BackgroundTestRunStatus } from "../../core/test/background-runs.js";
 /** Documents the start background run command options payload exchanged by command, SDK, and package integrations. */
 export interface StartBackgroundRunCommandOptions {
-    /** Value that configures or reports kind for this contract. */
-    kind: BackgroundTestRunKind;
-    /** Value that configures or reports command args for this contract. */
-    commandArgs: string[];
-    /** Value that configures or reports target id for this contract. */
-    targetId?: string;
-    /** Value that configures or reports status filter for this contract. */
-    statusFilter?: string;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
+/** Value that configures or reports kind for this contract. */
+kind: BackgroundTestRunKind;
+/** Value that configures or reports command args for this contract. */
+commandArgs: string[];
+/** Value that configures or reports target id for this contract. */
+targetId?: string;
+/** Value that configures or reports status filter for this contract. */
+statusFilter?: string;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions?: boolean;
 }
 /** Documents the start background run result payload exchanged by command, SDK, and package integrations. */
 export interface StartBackgroundRunResult {
-    /** Value that configures or reports started for this contract. */
-    started: boolean;
-    /** Value that configures or reports duplicate of for this contract. */
-    duplicate_of?: string;
-    /** Value that configures or reports run for this contract. */
-    run: unknown;
+/** Value that configures or reports started for this contract. */
+started: boolean;
+/** Value that configures or reports duplicate of for this contract. */
+duplicate_of?: string;
+/** Value that configures or reports run for this contract. */
+run: unknown;
 }
 /** Implements run start background run for the public runtime surface of this module. */
 export declare function runStartBackgroundRun(options: StartBackgroundRunCommandOptions, global: GlobalOptions): Promise<StartBackgroundRunResult>;
 /** Documents the test runs list command options payload exchanged by command, SDK, and package integrations. */
 export interface TestRunsListCommandOptions {
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Value that configures or reports limit for this contract. */
+limit?: string;
 }
 /** Implements run test runs list for the public runtime surface of this module. */
 export declare function runTestRunsList(options: TestRunsListCommandOptions, global: GlobalOptions): Promise<{
-    runs: unknown[];
-    count: number;
-    filters: {
-        status?: BackgroundTestRunStatus;
-        limit?: number;
-    };
+runs: unknown[];
+count: number;
+filters: {
+status?: BackgroundTestRunStatus;
+limit?: number;
+};
 }>;
 /** Implements run test runs status for the public runtime surface of this module. */
 export declare function runTestRunsStatus(runId: string, global: GlobalOptions): Promise<{
-    run: unknown;
-    health: unknown;
+run: unknown;
+health: unknown;
 }>;
 /** Documents the test runs logs command options payload exchanged by command, SDK, and package integrations. */
 export interface TestRunsLogsCommandOptions {
-    /** Value that configures or reports stream for this contract. */
-    stream?: string;
-    /** Value that configures or reports tail for this contract. */
-    tail?: string;
+/** Value that configures or reports stream for this contract. */
+stream?: string;
+/** Value that configures or reports tail for this contract. */
+tail?: string;
 }
 /** Implements run test runs logs for the public runtime surface of this module. */
 export declare function runTestRunsLogs(runId: string, options: TestRunsLogsCommandOptions, global: GlobalOptions): Promise<{
-    run: unknown;
-    stream: BackgroundLogStream;
-    tail: number;
-    stdout: string[];
-    stderr: string[];
+run: unknown;
+stream: BackgroundLogStream;
+tail: number;
+stdout: string[];
+stderr: string[];
 }>;
 /** Documents the test runs stop command options payload exchanged by command, SDK, and package integrations. */
 export interface TestRunsStopCommandOptions {
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
+/** Value that configures or reports force for this contract. */
+force?: boolean;
 }
 /** Implements run test runs stop for the public runtime surface of this module. */
 export declare function runTestRunsStop(runId: string, options: TestRunsStopCommandOptions, global: GlobalOptions): Promise<{
-    run: unknown;
-    signal_sent: "SIGTERM" | "SIGKILL" | "none";
+run: unknown;
+signal_sent: "SIGTERM" | "SIGKILL" | "none";
 }>;
 /** Documents the test runs resume command options payload exchanged by command, SDK, and package integrations. */
 export interface TestRunsResumeCommandOptions {
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions?: boolean;
 }
 /** Implements run test runs resume for the public runtime surface of this module. */
 export declare function runTestRunsResume(runId: string, options: TestRunsResumeCommandOptions, global: GlobalOptions): Promise<{
-    resumed_from: string;
-    run: unknown;
+resumed_from: string;
+run: unknown;
 }>;
 /** Implements run test runs worker for the public runtime surface of this module. */
 export declare function runTestRunsWorker(runId: string, global: GlobalOptions): Promise<{
-    id: string;
-    status: BackgroundTestRunStatus;
-    exit_code?: number;
+id: string;
+status: BackgroundTestRunStatus;
+exit_code?: number;
 }>;

package/dist/sdk/test/trust.d.ts

@@ -1,16 +1,16 @@
 import type { LinkedTest } from "../../types/index.js";
 /** Classification of one linked-test command against the current clone. */
 export interface LinkedTestTrustDecision {
-    /** Stable hash binding the decision to command, context, and provenance. */
-    fingerprint: string;
-    /** Whether execution may proceed without an untrusted-command override. */
-    trusted: boolean;
-    /** Machine-readable reason for the decision. */
-    reason: "legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
-    /** Source ref recorded when the command entered tracker data. */
-    source_ref?: string;
-    /** Current source ref used for the local decision. */
-    current_source_ref?: string;
+/** Stable hash binding the decision to command, context, and provenance. */
+fingerprint: string;
+/** Whether execution may proceed without an untrusted-command override. */
+trusted: boolean;
+/** Machine-readable reason for the decision. */
+reason: "legacy" | "local_mutation" | "local_source_ref" | "acknowledged" | "invalid_provenance" | "foreign_source_ref";
+/** Source ref recorded when the command entered tracker data. */
+source_ref?: string;
+/** Current source ref used for the local decision. */
+current_source_ref?: string;
 }
 /** Resolve the current Git branch without invoking a shell. */
 export declare function resolveLinkedTestSourceRef(cwd?: string): Promise<string | undefined>;
@@ -28,6 +28,6 @@ export declare function resolveLinkedTestTrust(pmRoot: string, test: LinkedTest,
 export declare function resolveLinkedTestTrustBatch(pmRoot: string, tests: LinkedTest[], currentSourceRef?: string): Promise<LinkedTestTrustDecision[]>;
 /** Persist explicit clone-local acknowledgement for selected linked tests. */
 export declare function acknowledgeLinkedTests(pmRoot: string, tests: LinkedTest[], acknowledgedAt: string): Promise<{
-    acknowledged: number;
-    fingerprints: string[];
+acknowledged: number;
+fingerprints: string[];
 }>;

package/dist/sdk/test/trust.js

@@ -1,3 +1,3 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="574bbc1f-493b-5c51-9c93-97234779a3ce")}catch{}})();import{execFile}from"node:child_process";import{readFile}from"node:fs/promises";import path from"node:path";import{promisify}from"node:util";import{ensureDir,writeFileAtomic}from"../../core/fs/fs-utils.js";import{sha256Hex,stableStringify}from"../../core/shared/serialization.js";import{isTimestampLiteral}from"../../core/shared/time.js";import{getRuntimePath}from"../../core/store/paths.js";const execFileAsync=promisify(execFile),LINKED_TEST_TRUST_LEDGER_VERSION=1,LINKED_TEST_TRUST_LEDGER_FILE="linked-test-trust.json";function trustLedgerPath(pmRoot){return path.join(getRuntimePath(pmRoot),LINKED_TEST_TRUST_LEDGER_FILE)}function emptyTrustLedger(){return{version:LINKED_TEST_TRUST_LEDGER_VERSION,acknowledged:{}}}async function readTrustLedger(pmRoot){try{const parsed=JSON.parse(await readFile(trustLedgerPath(pmRoot),"utf8"));return parsed.version!==LINKED_TEST_TRUST_LEDGER_VERSION||typeof parsed.acknowledged!="object"||parsed.acknowledged===null||Array.isArray(parsed.acknowledged)?emptyTrustLedger():{version:LINKED_TEST_TRUST_LEDGER_VERSION,acknowledged:parsed.acknowledged}}catch{return emptyTrustLedger()}}async function resolveLinkedTestSourceRef(cwd=process.cwd()){const hostedRef=process.env.GITHUB_HEAD_REF?.trim()||process.env.GITHUB_REF_NAME?.trim();if(hostedRef&&hostedRef!=="merge")return hostedRef;try{const{stdout}=await execFileAsync("git",["symbolic-ref","--quiet","--short","HEAD"],{cwd,encoding:"utf8",windowsHide:!0,timeout:1e4}),ref=stdout.trim();return ref.length===0?void 0:ref}catch{return}}function resolveLinkedTestSourceWorkspaceRoot(cwd=process.cwd()){return process.env.PM_SOURCE_WORKSPACE_ROOT?.trim()||cwd}function hasValidLinkedTestProvenance(provenance){return provenance===null||typeof provenance!="object"?!1:typeof provenance.author=="string"&&provenance.author.trim().length>0&&typeof provenance.created_at=="string"&&isTimestampLiteral(provenance.created_at)&&(provenance.source_kind==="local_mutation"||provenance.source_kind==="merge_union")}function linkedTestTrustRefs(sourceRef,currentSourceRef){return{...sourceRef?{source_ref:sourceRef}:{},...currentSourceRef?{current_source_ref:currentSourceRef}:{}}}function attachLinkedTestProvenance(tests,author,createdAt,sourceRef){return tests?.map(test=>test.command&&!test.provenance?{...test,provenance:{author,created_at:createdAt,source_kind:"local_mutation",...sourceRef?{source_ref:sourceRef}:{}}}:test)}async function attachLinkedTestMutationProvenance(tests,author,createdAt){if(!tests||tests.length===0)return tests;const sourceWorkspaceRoot=resolveLinkedTestSourceWorkspaceRoot();return attachLinkedTestProvenance(tests,author,createdAt,await resolveLinkedTestSourceRef(sourceWorkspaceRoot))}function linkedTestTrustFingerprint(test){return sha256Hex(stableStringify({command:test.command??null,path:test.path??null,scope:test.scope,pm_context_mode:test.pm_context_mode??null,workspace_context_mode:test.workspace_context_mode??null,env_set:test.env_set??null,env_clear:test.env_clear??null,shared_host_safe:test.shared_host_safe??null,provenance:test.provenance??null,provenance_invalid:test.provenance_invalid??null}))}async function resolveLinkedTestTrust(pmRoot,test,currentSourceRef){const ledger=await readTrustLedger(pmRoot);return resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger)}function resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger){const fingerprint=linkedTestTrustFingerprint(test),sourceRef=test.provenance?.source_ref;if(test.provenance===void 0&&test.provenance_invalid!==!0)return{fingerprint,trusted:!0,reason:"legacy"};const acknowledged=Object.hasOwn(ledger.acknowledged,fingerprint);return test.provenance_invalid===!0||!hasValidLinkedTestProvenance(test.provenance)?acknowledged?{fingerprint,trusted:!0,reason:"acknowledged",...linkedTestTrustRefs(void 0,currentSourceRef)}:{fingerprint,trusted:!1,reason:"invalid_provenance",...linkedTestTrustRefs(void 0,currentSourceRef)}:test.provenance.source_kind==="local_mutation"&&sourceRef===void 0?{fingerprint,trusted:!0,reason:"local_mutation",...linkedTestTrustRefs(void 0,currentSourceRef)}:test.provenance.source_kind==="local_mutation"&&sourceRef!==void 0&&sourceRef===currentSourceRef?{fingerprint,trusted:!0,reason:"local_source_ref",source_ref:sourceRef,current_source_ref:currentSourceRef}:acknowledged?{fingerprint,trusted:!0,reason:"acknowledged",...linkedTestTrustRefs(sourceRef,currentSourceRef)}:{fingerprint,trusted:!1,reason:"foreign_source_ref",...linkedTestTrustRefs(sourceRef,currentSourceRef)}}async function resolveLinkedTestTrustBatch(pmRoot,tests,currentSourceRef){const ledger=await readTrustLedger(pmRoot);return tests.map(test=>resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger))}async function acknowledgeLinkedTests(pmRoot,tests,acknowledgedAt){const ledger=await readTrustLedger(pmRoot),fingerprints=tests.filter(test=>typeof test.command=="string"&&test.command.length>0).map(linkedTestTrustFingerprint);for(const fingerprint of fingerprints)ledger.acknowledged[fingerprint]={acknowledged_at:acknowledgedAt};return await ensureDir(path.dirname(trustLedgerPath(pmRoot))),await writeFileAtomic(trustLedgerPath(pmRoot),`${JSON.stringify(ledger,null,2)}
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8f1a3301-8938-5208-9177-72ee29f3d174")}catch{}})();import{execFile}from"node:child_process";import{readFile}from"node:fs/promises";import path from"node:path";import{promisify}from"node:util";import{ensureDir,writeFileAtomic}from"../../core/fs/fs-utils.js";import{sha256Hex,stableStringify}from"../../core/shared/serialization.js";import{isTimestampLiteral}from"../../core/shared/time.js";import{getRuntimePath}from"../../core/store/paths.js";import{assertLinkedTestContext}from"./entry.js";const execFileAsync=promisify(execFile),LINKED_TEST_TRUST_LEDGER_VERSION=1,LINKED_TEST_TRUST_LEDGER_FILE="linked-test-trust.json";function trustLedgerPath(pmRoot){return path.join(getRuntimePath(pmRoot),LINKED_TEST_TRUST_LEDGER_FILE)}function emptyTrustLedger(){return{version:LINKED_TEST_TRUST_LEDGER_VERSION,acknowledged:{}}}async function readTrustLedger(pmRoot){try{const parsed=JSON.parse(await readFile(trustLedgerPath(pmRoot),"utf8"));return parsed.version!==LINKED_TEST_TRUST_LEDGER_VERSION||typeof parsed.acknowledged!="object"||parsed.acknowledged===null||Array.isArray(parsed.acknowledged)?emptyTrustLedger():{version:LINKED_TEST_TRUST_LEDGER_VERSION,acknowledged:parsed.acknowledged}}catch{return emptyTrustLedger()}}async function resolveLinkedTestSourceRef(cwd=process.cwd()){const hostedRef=process.env.GITHUB_HEAD_REF?.trim()||process.env.GITHUB_REF_NAME?.trim();if(hostedRef&&hostedRef!=="merge")return hostedRef;try{const{stdout}=await execFileAsync("git",["symbolic-ref","--quiet","--short","HEAD"],{cwd,encoding:"utf8",windowsHide:!0,timeout:1e4}),ref=stdout.trim();return ref.length===0?void 0:ref}catch{return}}function resolveLinkedTestSourceWorkspaceRoot(cwd=process.cwd()){return process.env.PM_SOURCE_WORKSPACE_ROOT?.trim()||cwd}function hasValidLinkedTestProvenance(provenance){return provenance===null||typeof provenance!="object"?!1:typeof provenance.author=="string"&&provenance.author.trim().length>0&&typeof provenance.created_at=="string"&&isTimestampLiteral(provenance.created_at)&&(provenance.source_kind==="local_mutation"||provenance.source_kind==="merge_union")}function linkedTestTrustRefs(sourceRef,currentSourceRef){return{...sourceRef?{source_ref:sourceRef}:{},...currentSourceRef?{current_source_ref:currentSourceRef}:{}}}function attachLinkedTestProvenance(tests,author,createdAt,sourceRef){return tests?.map(test=>test.command&&!test.provenance?{...test,provenance:{author,created_at:createdAt,source_kind:"local_mutation",...sourceRef?{source_ref:sourceRef}:{}}}:test)}async function attachLinkedTestMutationProvenance(tests,author,createdAt){if(!tests||tests.length===0)return tests;for(const test of tests)assertLinkedTestContext(test);const sourceWorkspaceRoot=resolveLinkedTestSourceWorkspaceRoot();return attachLinkedTestProvenance(tests,author,createdAt,await resolveLinkedTestSourceRef(sourceWorkspaceRoot))}function linkedTestTrustFingerprint(test){return sha256Hex(stableStringify({command:test.command??null,path:test.path??null,scope:test.scope,pm_context_mode:test.pm_context_mode??null,workspace_context_mode:test.workspace_context_mode??null,env_set:test.env_set??null,env_clear:test.env_clear??null,shared_host_safe:test.shared_host_safe??null,provenance:test.provenance??null,provenance_invalid:test.provenance_invalid??null}))}async function resolveLinkedTestTrust(pmRoot,test,currentSourceRef){const ledger=await readTrustLedger(pmRoot);return resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger)}function resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger){const fingerprint=linkedTestTrustFingerprint(test),sourceRef=test.provenance?.source_ref;if(test.provenance===void 0&&test.provenance_invalid!==!0)return{fingerprint,trusted:!0,reason:"legacy"};const acknowledged=Object.hasOwn(ledger.acknowledged,fingerprint);return test.provenance_invalid===!0||!hasValidLinkedTestProvenance(test.provenance)?acknowledged?{fingerprint,trusted:!0,reason:"acknowledged",...linkedTestTrustRefs(void 0,currentSourceRef)}:{fingerprint,trusted:!1,reason:"invalid_provenance",...linkedTestTrustRefs(void 0,currentSourceRef)}:test.provenance.source_kind==="local_mutation"&&sourceRef===void 0?{fingerprint,trusted:!0,reason:"local_mutation",...linkedTestTrustRefs(void 0,currentSourceRef)}:test.provenance.source_kind==="local_mutation"&&sourceRef!==void 0&&sourceRef===currentSourceRef?{fingerprint,trusted:!0,reason:"local_source_ref",source_ref:sourceRef,current_source_ref:currentSourceRef}:acknowledged?{fingerprint,trusted:!0,reason:"acknowledged",...linkedTestTrustRefs(sourceRef,currentSourceRef)}:{fingerprint,trusted:!1,reason:"foreign_source_ref",...linkedTestTrustRefs(sourceRef,currentSourceRef)}}async function resolveLinkedTestTrustBatch(pmRoot,tests,currentSourceRef){const ledger=await readTrustLedger(pmRoot);return tests.map(test=>resolveLinkedTestTrustFromLedger(test,currentSourceRef,ledger))}async function acknowledgeLinkedTests(pmRoot,tests,acknowledgedAt){const ledger=await readTrustLedger(pmRoot),fingerprints=tests.filter(test=>typeof test.command=="string"&&test.command.length>0).map(linkedTestTrustFingerprint);for(const fingerprint of fingerprints)ledger.acknowledged[fingerprint]={acknowledged_at:acknowledgedAt};return await ensureDir(path.dirname(trustLedgerPath(pmRoot))),await writeFileAtomic(trustLedgerPath(pmRoot),`${JSON.stringify(ledger,null,2)}
 `),{acknowledged:fingerprints.length,fingerprints}}export{acknowledgeLinkedTests,attachLinkedTestMutationProvenance,attachLinkedTestProvenance,linkedTestTrustFingerprint,resolveLinkedTestSourceRef,resolveLinkedTestSourceWorkspaceRoot,resolveLinkedTestTrust,resolveLinkedTestTrustBatch};
 //# sourceMappingURL=trust.js.map

package/dist/sdk/test/update.d.ts

@@ -0,0 +1,55 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { LinkedTest } from "../../types/index.js";
+import type { TestCommandOptions } from "./execution.js";
+/** Unambiguous selector evaluated against the current locked collection. */
+export type LinkedTestUpdateSelector = {
+index: number;
+} | {
+command: string;
+} | {
+path: string;
+};
+/** Explicit metadata values; null removes an optional value without replacing other fields. */
+export type LinkedTestMetadataPatch = {
+[K in keyof Omit<LinkedTest, "command" | "provenance" | "provenance_invalid" | "updated_by" | "updated_at">]?: K extends "scope" ? LinkedTest[K] : LinkedTest[K] | null;
+};
+/** One metadata revision with ordinary mutation ownership and history controls. */
+export interface UpdateLinkedTestOptions {
+/** Current entry identity or one-based list position. */
+selector: LinkedTestUpdateSelector;
+/** Fields to change; command and provenance cannot be replaced. */
+patch: LinkedTestMetadataPatch;
+/** Explicit author override, otherwise the configured or detected identity. */
+author?: string;
+/** Explanation retained on the single history event. */
+message?: string;
+/** Explicit ownership override. */
+force?: boolean;
+}
+/** Receipt identifying the edited entry and semantically changed metadata. */
+export interface UpdateLinkedTestResult {
+/** Successful mutation or unchanged retry. */
+ok: true;
+/** Owning item ID. */
+id: string;
+/** Current ordered linked-test collection. */
+tests: LinkedTest[];
+/** Whether authoritative state changed. */
+changed: boolean;
+/** Current collection size. */
+count: number;
+/** One-based position of the selected entry. */
+updated_index: number;
+/** Explicit metadata keys whose normalized values changed. */
+updated_fields: string[];
+}
+/** Resolve transport edit flags without accepting ambiguous selectors or implicit replacement. */
+export declare function parseLinkedTestUpdateOptions(options: {
+update?: string;
+updateIndex?: string | number;
+setJson?: string;
+}): Pick<UpdateLinkedTestOptions, "selector" | "patch"> | undefined;
+/** Keep metadata editing a separate atomic operation from execution or other collection changes. */
+export declare function assertLinkedTestEditUsage(options: TestCommandOptions): void;
+/** Patch one linked-test entry atomically, keeping ordering and original command provenance. */
+export declare function updateLinkedTest(id: string, options: UpdateLinkedTestOptions, global?: GlobalOptions): Promise<UpdateLinkedTestResult>;

package/dist/sdk/test/update.js

@@ -0,0 +1,2 @@
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cfcc5f4f-caf0-5a2e-8a9d-219c3afb5d2d")}catch{}})();import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{normalizeLinkedTest}from"../../core/item/item-format.js";import{parseOnlyIndexValue}from"../../core/test/run-selectors.js";import{resolveAuthor}from"../../core/shared/author.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{stableValueEquals}from"../../core/shared/serialization.js";import{nowIso}from"../../core/shared/time.js";import{mutateItemWithHistoryContextResolver}from"../../core/store/item-store.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{assertLinkedTestContext,STRUCTURED_LINKED_TEST_KEYS}from"./entry.js";import{parseLinkedTestJsonEntries}from"./parsers.js";function parseLinkedTestUpdateOptions(options){if(options.update===void 0&&options.updateIndex===void 0&&options.setJson===void 0)return;if(options.update===void 0==(options.updateIndex===void 0)||options.setJson===void 0)throw new PmCliError("Use exactly one --update or --update-index with --set-json",EXIT_CODE.USAGE);let patch;try{patch=JSON.parse(options.setJson)}catch{throw new PmCliError("--set-json must contain a JSON object with explicit linked-test metadata fields",EXIT_CODE.USAGE)}if(options.updateIndex!==void 0)return{selector:{index:parseOnlyIndexValue(options.updateIndex,"--update-index")},patch};const value=options.update,prefix=/^(command|path)=/u.exec(value);return{selector:prefix?.[1]==="path"?{path:value.slice(prefix[0].length)}:{command:prefix?value.slice(prefix[0].length):value},patch}}function assertLinkedTestEditUsage(options){if([options.list,options.run,options.progress,options.timeout!==void 0,options.acknowledgeLinkedTests,options.metricBelow!==void 0,options.metricDiff!==void 0,(options.add?.length??0)>0,(options.addJson?.length??0)>0,(options.remove?.length??0)>0,(options.removeIndex?.length??0)>0].some(Boolean))throw new PmCliError("Edit linked-test metadata separately from listing, additions, removals, execution options, metric filters and trust acknowledgement",EXIT_CODE.USAGE)}function selectIndex(tests,selector){if(typeof selector!="object"||selector===null||Array.isArray(selector))throw new PmCliError("Select one linked test by index, command, or path",EXIT_CODE.USAGE);const keys=Object.keys(selector);if(keys.length!==1||!["index","command","path"].includes(keys[0]))throw new PmCliError("Select one linked test by index, command, or path",EXIT_CODE.USAGE);if("index"in selector){const index=parseOnlyIndexValue(selector.index,"--update-index");if(index<=tests.length)return index-1}else{const key="command"in selector?"command":"path",value="command"in selector?selector.command:selector.path;if(typeof value!="string"||value.trim().length===0)throw new PmCliError("Linked-test selector must be a non-empty command or path",EXIT_CODE.USAGE);const matches=tests.flatMap((test,index)=>test[key]===value?[index]:[]);if(matches.length===1)return matches[0];if(matches.length>1)throw new PmCliError(`Linked-test selector is ambiguous; matching indexes: ${matches.map(index=>index+1).join(", ")}`,EXIT_CODE.USAGE,{code:"linked_test_update_ambiguous",required:"List linked tests and select one current --update-index."})}throw new PmCliError("No linked test matched the update selector",EXIT_CODE.NOT_FOUND,{code:"linked_test_update_no_match",required:"List linked tests and select a current command, path, or --update-index."})}function applyPatch(test,patch){if(typeof patch!="object"||patch===null||Array.isArray(patch))throw new PmCliError("Linked-test metadata patch must be a JSON object",EXIT_CODE.USAGE);const keys=Object.keys(patch);if(keys.length===0||keys.some(key=>!STRUCTURED_LINKED_TEST_KEYS.includes(key)||["command","cmd","timeout"].includes(key)))throw new PmCliError("Patch explicit linked-test metadata fields; command, aliases and provenance cannot be edited",EXIT_CODE.USAGE);if(patch.scope===null)throw new PmCliError("scope is required and cannot be cleared",EXIT_CODE.USAGE);const metadata=Object.fromEntries(Object.entries(test).filter(([key])=>STRUCTURED_LINKED_TEST_KEYS.includes(key))),parsed=normalizeLinkedTest(parseLinkedTestJsonEntries(JSON.stringify({...metadata,command:test.command??"legacy-path-only",...Object.fromEntries(Object.entries(patch).map(([key,value])=>[key,value===null?void 0:value]))}),"--set-json")[0]);assertLinkedTestContext(parsed);const fields=keys.filter(key=>!stableValueEquals(test[key],parsed[key])),next={...test};for(const key of fields){const value=parsed[key];Object.assign(next,{[key]:value}),value===void 0&&delete next[key]}if(!next.command?.trim()&&!next.path?.trim())throw new PmCliError("Linked-test entry must retain a command or path",EXIT_CODE.USAGE);return{test:next,fields}}async function updateLinkedTest(id,options,global2={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot),author=resolveAuthor(options.author,settings.author_default),typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());let updatedIndex=0,updatedFields=[];const result=await mutateItemWithHistoryContextResolver({pmRoot,settings,id,author,op:"tests_update",message:options.message,force:options.force,skipNoop:!0,typeToFolder:typeRegistry.type_to_folder,resolveHistoryContext:()=>({linked_test_update:{index:updatedIndex,fields:updatedFields}}),mutate(document){const tests2=document.metadata.tests??[],index=selectIndex(tests2,options.selector),patch=applyPatch(tests2[index],options.patch);return updatedIndex=index+1,updatedFields=patch.fields,patch.fields.length===0?{changedFields:[]}:(document.metadata.tests=tests2.map((test,position)=>position===index?{...patch.test,updated_by:author,updated_at:nowIso()}:test),{changedFields:["tests"]})}}),tests=result.item.tests;return{ok:!0,id:result.item.id,tests,count:tests.length,changed:result.changedFields.length>0,updated_index:updatedIndex,updated_fields:updatedFields}}export{assertLinkedTestEditUsage,parseLinkedTestUpdateOptions,updateLinkedTest};
+//# sourceMappingURL=update.js.map