@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/package-runtime-options.d.ts

@@ -10,14 +10,14 @@
  * permitted to import.
  */
 /** Returns the first non-empty string value found for `key` or any alias. */
-export declare function readStringOption(options: Record<string, unknown>, key: string, aliases?: string[]): string | undefined;
+export declare function readStringOption(options:Record<string,unknown>,key:string,aliases?:string[]):string | undefined;
 /**
  * Coerces the first defined value found for `key` or any alias into a boolean.
  *
  * Accepts native booleans and the canonical truthy/falsy string literals; any
  * other value is ignored so a later alias can still match.
  */
-export declare function readBooleanOption(options: Record<string, unknown>, key: string, aliases?: string[]): boolean | undefined;
+export declare function readBooleanOption(options:Record<string,unknown>,key:string,aliases?:string[]):boolean | undefined;
 /**
  * Normalizes a comma-separated or Commander-accumulated list option.
  *
@@ -26,4 +26,4 @@ export declare function readBooleanOption(options: Record<string, unknown>, key:
  * shapes lets package runtimes consume canonical `list` flag contracts without
  * reimplementing option coercion.
  */
-export declare function readCsvListOption(options: Record<string, unknown>, key: string, aliases?: string[]): string[];
+export declare function readCsvListOption(options:Record<string,unknown>,key:string,aliases?:string[]):string[];

package/dist/sdk/pagination.d.ts

@@ -2,62 +2,62 @@ import type { CliFlagContract } from "./cli-contracts/flag-contracts.js";
 /** Validated transport envelope carried by an opaque query cursor. */
 export interface QueryCursorEnvelope {
 /** Serialized cursor contract version. */
-version: number;
+version:number;
 /** Stable fingerprint of the query semantics that produced the cursor. */
-fingerprint: string;
+fingerprint:string;
 /** Stable id of the last row emitted by the producer. */
-after_id: string;
+after_id:string;
 /** Zero-based position of the last emitted row when available. */
-after_index?: number;
+after_index?:number;
 /** Opaque producer-defined snapshot token for stable continuation. */
-snapshot?: string;
+snapshot?:string;
 }
 /** Decoded cursor state for advanced package and retrieval-window integrations. */
 export interface QueryCursorState {
 /** Stable id of the last row emitted by the previous page. */
-after_id: string;
+after_id:string;
 /** Zero-based position of that row when the producer supplied one. */
-after_index?: number;
+after_index?:number;
 /** Opaque producer-defined snapshot token for stable continuation. */
-snapshot?: string;
+snapshot?:string;
 }
 /** Describes one stable cursor page over an already ordered query result. */
 export interface QueryCursorPage<T> {
 /** Rows contained in the requested page. */
-rows: T[];
+rows:T[];
 /** Whether another page exists after these rows. */
-has_more: boolean;
+has_more:boolean;
 /** Opaque cursor for the next page when one exists. */
-next_cursor?: string;
+next_cursor?:string;
 }
 /**
  * Select the query-semantic portion of an options object from published flag
  * contracts. Query semantics are the compact fail-safe default; contracts
  * explicitly mark only presentation-only exceptions.
  */
-export declare function selectCursorSemanticOptions(options: Readonly<Record<string, unknown>>, contracts: readonly CliFlagContract[]): Record<string, unknown>;
+export declare function selectCursorSemanticOptions(options:Readonly<Record<string,unknown>>,contracts:readonly CliFlagContract[]):Record<string,unknown>;
 /** Build a compact deterministic fingerprint for a normalized query contract. */
-export declare function createQueryFingerprint(command: string, contract: unknown): string;
+export declare function createQueryFingerprint(command:string,contract:unknown):string;
 /** Encode the last emitted item id into a versioned opaque base64url cursor. */
-export declare function encodeQueryCursor(fingerprint: string, afterId: string, afterIndex?: number, snapshot?: string): string;
+export declare function encodeQueryCursor(fingerprint:string,afterId:string,afterIndex?:number,snapshot?:string):string;
 /** Decode and validate an opaque cursor without imposing caller query identity. */
-export declare function decodeQueryCursorEnvelope(cursor: unknown): QueryCursorEnvelope;
+export declare function decodeQueryCursorEnvelope(cursor:unknown):QueryCursorEnvelope;
 /** Decode and validate complete cursor state against a query fingerprint. */
-export declare function decodeQueryCursorState(cursor: unknown, expectedFingerprint: string): QueryCursorState;
+export declare function decodeQueryCursorState(cursor:unknown,expectedFingerprint:string):QueryCursorState;
 /** Decode and validate a cursor against the normalized query fingerprint. */
-export declare function decodeQueryCursor(cursor: unknown, expectedFingerprint: string): string;
+export declare function decodeQueryCursor(cursor:unknown,expectedFingerprint:string):string;
 /** Resolve the first row after a validated cursor's stable id tiebreaker. */
-export declare function resolveQueryCursorStart<T>(rows: readonly T[], cursor: string | undefined, fingerprint: string, readId: (row: T) => string): number;
+export declare function resolveQueryCursorStart<T>(rows:readonly T[],cursor:string | undefined,fingerprint:string,readId:(row:T) => string):number;
 /** Page an ordered result through the shared stable cursor contract. */
-export declare function paginateQueryRows<T>(rows: readonly T[], options: {
-cursor?: string;
-fingerprint: string;
-limit: number;
-readId: (row: T) => string;
-snapshot?: string;
-}): QueryCursorPage<T>;
+export declare function paginateQueryRows<T>(rows:readonly T[],options:{
+cursor?:string;
+fingerprint:string;
+limit:number;
+readId:(row:T) => string;
+snapshot?:string;
+}):QueryCursorPage<T>;
 /** Public pagination constants exposed for package authors and contract tests. */
-export declare const QUERY_CURSOR_CONTRACT: Readonly<{
-version: 1;
-max_length: 4096;
+export declare const QUERY_CURSOR_CONTRACT:Readonly<{
+version:1;
+max_length:4096;
 }>;

package/dist/sdk/pagination.js

@@ -1,2 +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]="d60ea0a7-96d4-5a22-92bd-ac64eece5a51")}catch{}})();import{READ_OUTPUT_DIMENSION_FLAGS,READ_OUTPUT_COMPOSITION_FLAGS}from"./read-output/options.js";import{createHash}from"node:crypto";import{PmCliError}from"../core/shared/errors.js";import{EXIT_CODE}from"../core/shared/constants.js";import{stableStringify}from"../core/shared/serialization.js";const QUERY_CURSOR_VERSION=1,MAX_CURSOR_LENGTH=4096,BASE64URL_PATTERN=/^[A-Za-z0-9_-]+$/;function optionKeyForFlag(flag){return flag.replace(/^--/u,"").replace(/[-_]([a-z0-9])/gu,(_,character)=>character.toUpperCase())}function selectCursorSemanticOptions(options,contracts){const universalFlags=[...Object.values(READ_OUTPUT_DIMENSION_FLAGS),...READ_OUTPUT_COMPOSITION_FLAGS],presentationKeys=new Set(universalFlags.flatMap(flag=>[optionKeyForFlag(flag),flag.slice(2).replaceAll("-","_")]));for(const contract of contracts)if(contract.cursor_semantics==="presentation"){presentationKeys.add(optionKeyForFlag(contract.flag));for(const alias of contract.aliases??[])presentationKeys.add(optionKeyForFlag(alias))}return Object.fromEntries(Object.entries(options).filter(([key])=>!presentationKeys.has(key)))}function createQueryFingerprint(command,contract){return createHash("sha256").update(command).update("\0").update(stableStringify(contract)).digest("hex").slice(0,24)}function encodeQueryCursor(fingerprint,afterId,afterIndex,snapshot){return Buffer.from(JSON.stringify({version:QUERY_CURSOR_VERSION,fingerprint,after_id:afterId,...afterIndex===void 0?{}:{after_index:afterIndex},...snapshot===void 0?{}:{snapshot}})).toString("base64url")}function invalidCursor(message){return new PmCliError(message,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:["Repeat the original query without --after to obtain a fresh cursor."]})}function isQueryCursorEnvelope(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const envelope=value;return envelope.version===QUERY_CURSOR_VERSION&&typeof envelope.fingerprint=="string"&&typeof envelope.after_id=="string"&&envelope.after_id.length>0&&(envelope.after_index===void 0||Number.isSafeInteger(envelope.after_index)&&envelope.after_index>=0)&&(envelope.snapshot===void 0||typeof envelope.snapshot=="string"&&envelope.snapshot.length>0)}function decodeQueryCursorEnvelope(cursor){if(typeof cursor!="string")throw invalidCursor("Query cursor is malformed.");const normalized=cursor.trim();if(normalized.length===0||normalized.length>MAX_CURSOR_LENGTH||!BASE64URL_PATTERN.test(normalized))throw invalidCursor("Query cursor is malformed.");let parsed;try{parsed=JSON.parse(Buffer.from(normalized,"base64url").toString("utf8"))}catch{throw invalidCursor("Query cursor is malformed.")}if(!isQueryCursorEnvelope(parsed))throw invalidCursor("Query cursor version or payload is unsupported.");return parsed}function decodeQueryCursorState(cursor,expectedFingerprint){const envelope=decodeQueryCursorEnvelope(cursor);if(envelope.fingerprint!==expectedFingerprint)throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`);return{after_id:envelope.after_id,...envelope.after_index===void 0?{}:{after_index:envelope.after_index},...envelope.snapshot===void 0?{}:{snapshot:envelope.snapshot}}}function decodeQueryCursor(cursor,expectedFingerprint){return decodeQueryCursorState(cursor,expectedFingerprint).after_id}function resolveQueryCursorStart(rows,cursor,fingerprint,readId){if(cursor===void 0)return 0;const state=decodeQueryCursorState(cursor,fingerprint),index=rows.findIndex(row=>readId(row)===state.after_id);if(index<0){if(state.after_index!==void 0)return Math.min(state.after_index,rows.length);throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`)}return index+1}function paginateQueryRows(rows,options){if(options.cursor!==void 0&&decodeQueryCursorState(options.cursor,options.fingerprint).snapshot!==options.snapshot)throw invalidCursor("Query cursor does not match the requested snapshot.");const pageStart=resolveQueryCursorStart(rows,options.cursor,options.fingerprint,options.readId),pageRows=rows.slice(pageStart,pageStart+options.limit),hasMore=pageRows.length>0&&pageStart+pageRows.length<rows.length,lastRow=pageRows.at(-1);return{rows:pageRows,has_more:hasMore,...hasMore&&lastRow!==void 0?{next_cursor:encodeQueryCursor(options.fingerprint,options.readId(lastRow),pageStart+pageRows.length-1,options.snapshot)}:{}}}const QUERY_CURSOR_CONTRACT=Object.freeze({version:QUERY_CURSOR_VERSION,max_length:MAX_CURSOR_LENGTH});export{QUERY_CURSOR_CONTRACT,createQueryFingerprint,decodeQueryCursor,decodeQueryCursorEnvelope,decodeQueryCursorState,encodeQueryCursor,paginateQueryRows,resolveQueryCursorStart,selectCursorSemanticOptions};
+(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]="400de68f-104b-5a25-9e79-f69da940832f")}catch{}})();import{READ_OUTPUT_DIMENSION_FLAGS,READ_OUTPUT_COMPOSITION_FLAGS}from"./read-output/options.js";import{createHash}from"node:crypto";import{PmCliError}from"../core/shared/errors.js";import{EXIT_CODE}from"../core/shared/constants.js";import{stableStringify}from"../core/shared/serialization.js";import{decodeReadOutputContinuationCursor}from"./read-output/continuation.js";const QUERY_CURSOR_VERSION=1,MAX_CURSOR_LENGTH=4096,BASE64URL_PATTERN=/^[A-Za-z0-9_-]+$/;function optionKeyForFlag(flag){return flag.replace(/^--/u,"").replace(/[-_]([a-z0-9])/gu,(_,character)=>character.toUpperCase())}function selectCursorSemanticOptions(options,contracts){const universalFlags=[...Object.values(READ_OUTPUT_DIMENSION_FLAGS),...READ_OUTPUT_COMPOSITION_FLAGS],presentationKeys=new Set(universalFlags.flatMap(flag=>[optionKeyForFlag(flag),flag.slice(2).replaceAll("-","_")]));for(const contract of contracts)if(contract.cursor_semantics==="presentation"){presentationKeys.add(optionKeyForFlag(contract.flag));for(const alias of contract.aliases??[])presentationKeys.add(optionKeyForFlag(alias))}return Object.fromEntries(Object.entries(options).filter(([key])=>!presentationKeys.has(key)))}function createQueryFingerprint(command,contract){return createHash("sha256").update(command).update("\0").update(stableStringify(contract)).digest("hex").slice(0,24)}function encodeQueryCursor(fingerprint,afterId,afterIndex,snapshot){return Buffer.from(JSON.stringify({version:QUERY_CURSOR_VERSION,fingerprint,after_id:afterId,...afterIndex===void 0?{}:{after_index:afterIndex},...snapshot===void 0?{}:{snapshot}})).toString("base64url")}function invalidCursor(message){return new PmCliError(message,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:["Repeat the original query without --after to obtain a fresh cursor."]})}function isQueryCursorEnvelope(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const envelope=value;return envelope.version===QUERY_CURSOR_VERSION&&typeof envelope.fingerprint=="string"&&typeof envelope.after_id=="string"&&envelope.after_id.length>0&&(envelope.after_index===void 0||Number.isSafeInteger(envelope.after_index)&&envelope.after_index>=0)&&(envelope.snapshot===void 0||typeof envelope.snapshot=="string"&&envelope.snapshot.length>0)}function decodeQueryCursorEnvelope(cursor){if(typeof cursor!="string")throw invalidCursor("Query cursor is malformed.");const normalized=cursor.trim();if(normalized.length===0||normalized.length>MAX_CURSOR_LENGTH||!BASE64URL_PATTERN.test(normalized))throw invalidCursor("Query cursor is malformed.");let parsed;try{parsed=JSON.parse(Buffer.from(normalized,"base64url").toString("utf8"))}catch{throw invalidCursor("Query cursor is malformed.")}if(!isQueryCursorEnvelope(parsed)){let outputCursor=!1;try{decodeReadOutputContinuationCursor(normalized),outputCursor=!0}catch{}throw outputCursor?new PmCliError("An output cursor must be continued with --output-cursor, not --after.",EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:[`Repeat the same query, replacing --after with --output-cursor ${normalized}; retain any producer --after cursor from the original page.`]}):invalidCursor("Query cursor version or payload is unsupported.")}return parsed}function decodeQueryCursorState(cursor,expectedFingerprint){const envelope=decodeQueryCursorEnvelope(cursor);if(envelope.fingerprint!==expectedFingerprint)throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`);return{after_id:envelope.after_id,...envelope.after_index===void 0?{}:{after_index:envelope.after_index},...envelope.snapshot===void 0?{}:{snapshot:envelope.snapshot}}}function decodeQueryCursor(cursor,expectedFingerprint){return decodeQueryCursorState(cursor,expectedFingerprint).after_id}function resolveQueryCursorStart(rows,cursor,fingerprint,readId){if(cursor===void 0)return 0;const state=decodeQueryCursorState(cursor,fingerprint),index=rows.findIndex(row=>readId(row)===state.after_id);if(index<0){if(state.after_index!==void 0)return Math.min(state.after_index,rows.length);throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`)}return index+1}function paginateQueryRows(rows,options){if(options.cursor!==void 0&&decodeQueryCursorState(options.cursor,options.fingerprint).snapshot!==options.snapshot)throw invalidCursor("Query cursor does not match the requested snapshot.");const pageStart=resolveQueryCursorStart(rows,options.cursor,options.fingerprint,options.readId),pageRows=rows.slice(pageStart,pageStart+options.limit),hasMore=pageRows.length>0&&pageStart+pageRows.length<rows.length,lastRow=pageRows.at(-1);return{rows:pageRows,has_more:hasMore,...hasMore&&lastRow!==void 0?{next_cursor:encodeQueryCursor(options.fingerprint,options.readId(lastRow),pageStart+pageRows.length-1,options.snapshot)}:{}}}const QUERY_CURSOR_CONTRACT=Object.freeze({version:QUERY_CURSOR_VERSION,max_length:MAX_CURSOR_LENGTH});export{QUERY_CURSOR_CONTRACT,createQueryFingerprint,decodeQueryCursor,decodeQueryCursorEnvelope,decodeQueryCursorState,encodeQueryCursor,paginateQueryRows,resolveQueryCursorStart,selectCursorSemanticOptions};
 //# sourceMappingURL=pagination.js.map

package/dist/sdk/profile.d.ts

@@ -3,7 +3,7 @@ import { type ProfileSourceKind } from "../core/profile/profile-presets.js";
 import { type ProjectProfileComposition } from "../core/profile/profile-describe.js";
 import { type ProjectProfileLintFinding } from "../core/profile/profile-lint.js";
 /** Ordered `pm profile` subcommands. */
-export declare const PROFILE_SUBCOMMANDS: readonly ["list", "show", "apply", "lint"];
+export declare const PROFILE_SUBCOMMANDS:readonly ["list","show","apply","lint"];
 /** Restricts profile subcommand values accepted by command, SDK, and storage contracts. */
 export type ProfileSubcommand = (typeof PROFILE_SUBCOMMANDS)[number];
 /**
@@ -15,162 +15,162 @@ export type ProfileComposition = ProjectProfileComposition;
 /** A single profile entry in the `pm profile list` payload. */
 export interface ProfileListEntry {
 /** Profile name. */
-name: string;
+name:string;
 /** Display title. */
-title: string;
+title:string;
 /** One-line archetype summary. */
-summary: string;
+summary:string;
 /** Whether the profile is core-baked or contributed by an active extension. */
-source: ProfileSourceKind;
+source:ProfileSourceKind;
 /** Owning package/extension name for an extension profile; omitted for builtins. */
-package?: string;
+package?:string;
 /** Per-dimension counts. */
-composition: ProfileComposition;
+composition:ProfileComposition;
 }
 /** Result of `pm profile list`. */
 export interface ProfileListResult {
 /** Discriminant for the profile result union. */
-action: "list";
+action:"list";
 /** Built-in profiles in canonical order followed by active extension profiles. */
-profiles: ProfileListEntry[];
+profiles:ProfileListEntry[];
 /** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
-warnings: string[];
+warnings:string[];
 /** ISO timestamp the result was produced. */
-generated_at: string;
+generated_at:string;
 }
 /** Result of `pm profile show <name>`. */
 export interface ProfileShowResult {
 /** Discriminant for the profile result union. */
-action: "show";
+action:"show";
 /** Profile name. */
-name: string;
+name:string;
 /** Display title. */
-title: string;
+title:string;
 /** One-line archetype summary. */
-summary: string;
+summary:string;
 /** Whether the profile is core-baked or contributed by an active extension. */
-source: ProfileSourceKind;
+source:ProfileSourceKind;
 /** Owning package/extension name for an extension profile; omitted for builtins. */
-package?: string;
+package?:string;
 /** Per-dimension counts. */
-composition: ProfileComposition;
+composition:ProfileComposition;
 /** Item type names the profile registers. */
-types: string[];
+types:string[];
 /** Custom status ids. */
-statuses: string[];
+statuses:string[];
 /** Custom field keys. */
-fields: string[];
+fields:string[];
 /** Item types governed by a staged workflow. */
-workflows: string[];
+workflows:string[];
 /** Config knobs as `key=value` pairs. */
-config: string[];
+config:string[];
 /** Template names the profile stages. */
-templates: string[];
+templates:string[];
 /** Recommended package specs with rationale. */
-packages: Array<{
-spec: string;
-reason: string;
+packages:Array<{
+spec:string;
+reason:string;
 }>;
 /** Non-fatal merge warnings (built-in shadowing attempts, duplicate names). */
-warnings: string[];
+warnings:string[];
 /** ISO timestamp the result was produced. */
-generated_at: string;
+generated_at:string;
 }
 /** Per-dimension change summary in an apply result. */
 export interface ProfileApplyDimension {
 /** Entry keys that were newly created. */
-added: string[];
+added:string[];
 /** Entry keys whose stored value was overwritten. */
-updated: string[];
+updated:string[];
 /** Entry keys already current (no write). */
-unchanged: string[];
+unchanged:string[];
 }
 /** Result of `pm profile apply <name>`. */
 export interface ProfileApplyResult {
 /** Discriminant for the profile result union. */
-action: "apply";
+action:"apply";
 /** Applied profile name. */
-name: string;
+name:string;
 /** Display title. */
-title: string;
+title:string;
 /** True when changes were persisted; false for `--dry-run` or a no-op. */
-applied: boolean;
+applied:boolean;
 /** True when `--dry-run` previewed without writing. */
-dry_run: boolean;
+dry_run:boolean;
 /** True when at least one dimension stages an add/update. */
-changed: boolean;
+changed:boolean;
 /** Item-type change summary. */
-types: ProfileApplyDimension;
+types:ProfileApplyDimension;
 /** Status change summary. */
-statuses: ProfileApplyDimension;
+statuses:ProfileApplyDimension;
 /** Field change summary. */
-fields: ProfileApplyDimension;
+fields:ProfileApplyDimension;
 /** Workflow change summary. */
-workflows: ProfileApplyDimension;
+workflows:ProfileApplyDimension;
 /** Config-knob change summary. */
-config: ProfileApplyDimension;
+config:ProfileApplyDimension;
 /** Template change summary. */
-templates: ProfileApplyDimension;
+templates:ProfileApplyDimension;
 /** Advisory package recommendations with install status. */
-packages: Array<{
-spec: string;
-reason: string;
-status: "installed" | "recommended";
+packages:Array<{
+spec:string;
+reason:string;
+status:"installed" | "recommended";
 }>;
 /** Deduped on-write hook + advisory warnings. */
-warnings: string[];
+warnings:string[];
 /** ISO timestamp the result was produced. */
-generated_at: string;
+generated_at:string;
 }
 /** Result of `pm profile lint [name]`. */
 export interface ProfileLintResult {
 /** Discriminant for the profile result union. */
-action: "lint";
+action:"lint";
 /** Linted profile name. */
-name: string;
+name:string;
 /** Display title. */
-title: string;
+title:string;
 /** Whether the profile is core-baked or contributed by an active extension. */
-source: ProfileSourceKind;
+source:ProfileSourceKind;
 /** Owning package/extension name for an extension profile; omitted for builtins. */
-package?: string;
+package?:string;
 /** True when the profile produced no error-severity findings. */
-ok: boolean;
+ok:boolean;
 /** Count of error-severity findings. */
-error_count: number;
+error_count:number;
 /** Count of warning-severity findings. */
-warning_count: number;
+warning_count:number;
 /** Every graded consistency finding in dimension order. */
-findings: ProjectProfileLintFinding[];
+findings:ProjectProfileLintFinding[];
 /** Non-fatal catalog merge warnings (built-in shadowing attempts, duplicate names). */
-warnings: string[];
+warnings:string[];
 /** ISO timestamp the result was produced. */
-generated_at: string;
+generated_at:string;
 }
 /** Discriminated union of every `pm profile` result shape. */
 export type ProfileResult = ProfileListResult | ProfileShowResult | ProfileApplyResult | ProfileLintResult;
 /** Lists every available profile — the built-in archetypes followed by profiles contributed by active extensions — with per-dimension composition counts and the source each came from. Surfaces any non-fatal merge collisions as warnings. */
-export declare function runProfileList(): ProfileListResult;
+export declare function runProfileList():ProfileListResult;
 /** Shows the full composition of a single profile, resolved across built-in and extension-contributed archetypes. Throws a USAGE error for a missing or unknown profile name. */
-export declare function runProfileShow(name: string | undefined): ProfileShowResult;
+export declare function runProfileShow(name:string | undefined):ProfileShowResult;
 /** Lints a single profile, resolved across built-in and extension-contributed archetypes, returning every graded consistency finding plus any catalog merge warnings. Throws a USAGE error for a missing or unknown profile name. This is the read-only author-time validation surface; it never writes to the tracker. */
-export declare function runProfileLint(name: string | undefined): ProfileLintResult;
+export declare function runProfileLint(name:string | undefined):ProfileLintResult;
 /** Options accepted by {@link runProfileApply}. */
 export interface ProfileApplyCommandOptions {
 /** Preview the diff without writing any files. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Mutation author override. */
-author?: string;
+author?:string;
 /** Force ownership/lock override. */
-force?: boolean;
+force?:boolean;
 }
 /** Applies a profile to the initialized tracker, or previews the idempotent diff when `dryRun` is set. Schema files are written under their respective locks; config and workflows are persisted to settings; templates are staged via the shared template writer. Re-applying an already-applied profile performs zero writes. Throws a USAGE error for an unknown profile or an invalid config knob, and a NOT_FOUND error when the tracker is not initialized. */
-export declare function runProfileApply(name: string | undefined, options: ProfileApplyCommandOptions, global: GlobalOptions): Promise<ProfileApplyResult>;
+export declare function runProfileApply(name:string | undefined,options:ProfileApplyCommandOptions,global:GlobalOptions):Promise<ProfileApplyResult>;
 /** Renders the `pm profile list` result as human-readable text. */
-export declare function formatProfileListHuman(result: ProfileListResult): string;
+export declare function formatProfileListHuman(result:ProfileListResult):string;
 /** Renders the `pm profile show` result as human-readable text. */
-export declare function formatProfileShowHuman(result: ProfileShowResult): string;
+export declare function formatProfileShowHuman(result:ProfileShowResult):string;
 /** Renders the `pm profile lint` result as human-readable text: a one-line verdict followed by each finding prefixed with its severity, code, and dimension. */
-export declare function formatProfileLintHuman(result: ProfileLintResult): string;
+export declare function formatProfileLintHuman(result:ProfileLintResult):string;
 /** Renders the `pm profile apply` result as human-readable text, including the staged diff and any package recommendations. */
-export declare function formatProfileApplyHuman(result: ProfileApplyResult): string;
+export declare function formatProfileApplyHuman(result:ProfileApplyResult):string;

package/dist/sdk/provenance.d.ts

@@ -9,105 +9,105 @@ import type { AgentModelSource } from "../core/shared/author.js";
 /** One declared provenance dimension and the built-in harnesses that can supply it. */
 export interface AgentProvenanceDescriptorCoverage {
 /** Stable provenance dimension name. */
-dimension: string;
+dimension:string;
 /** Built-in harnesses declaring at least one source for the dimension. */
-harnesses: string[];
+harnesses:string[];
 /** Whether at least one built-in harness can populate the dimension. */
-covered: boolean;
+covered:boolean;
 }
 /** Model-provenance coverage for one harness over a bounded history window. */
 export interface AgentModelProvenanceCoverage {
 /** Stable detected harness namespace. */
-harness: string;
+harness:string;
 /** History events attributed to the harness. */
-entries: number;
+entries:number;
 /** Events carrying an observed model. */
-observed: number;
+observed:number;
 /** Events explicitly recording that the model was unavailable. */
-unavailable: number;
+unavailable:number;
 /** Legacy events written before explicit availability existed. */
-legacy_missing: number;
+legacy_missing:number;
 /** Observed fraction among events with explicit availability. */
-coverage: number | null;
+coverage:number | null;
 /** True when a sampled declared signal produced only unavailable values. */
-inert: boolean;
+inert:boolean;
 }
 /** Availability coverage for one provenance dimension on one harness. */
 export interface AgentProvenanceDimensionCoverage extends AgentModelProvenanceCoverage {
 /** Stable provenance dimension being summarized. */
-dimension: string;
+dimension:string;
 }
 /** Semantic attribution coverage for one harness and role/topic dimension. */
 export interface AgentSemanticAttributionCoverage {
 /** Stable detected harness namespace. */
-harness: string;
+harness:string;
 /** Semantic dimension being measured. */
-dimension: "role" | "topic";
+dimension:"role" | "topic";
 /** History events attributed to the harness. */
-entries: number;
+entries:number;
 /** Events carrying a non-empty semantic observation. */
-observed: number;
+observed:number;
 /** Observed events grouped by precedence source. */
-by_source: Partial<Record<AgentModelSource, number>>;
+by_source:Partial<Record<AgentModelSource,number>>;
 /** Observed fraction across all harness events. */
-coverage: number;
+coverage:number;
 }
 /** Result of applying a corpus-facing semantic coverage threshold. */
 export interface AgentSemanticAttributionCoverageGate {
 /** Whether every sampled harness/dimension row met the threshold. */
-passed: boolean;
+passed:boolean;
 /** Required observed fraction. */
-minimum_coverage: number;
+minimum_coverage:number;
 /** Required event count before a row participates. */
-minimum_entries: number;
+minimum_entries:number;
 /** Deterministically ordered coverage rows. */
-rows: AgentSemanticAttributionCoverage[];
+rows:AgentSemanticAttributionCoverage[];
 /** Harness/dimension keys that failed the threshold. */
-failures: string[];
+failures:string[];
 }
 /** One declared or inferred episode group with deterministically nested children. */
 export interface AgentEpisodeGroup {
 /** Stable declared or inferred group key. */
-id: string;
+id:string;
 /** Optional declared human-readable purpose. */
-label?: string;
+label?:string;
 /** Optional declared parent episode key. */
-parent_id?: string;
+parent_id?:string;
 /** Whether the grouping key was recorded or reconstructed. */
-source: "declared" | "inferred";
+source:"declared" | "inferred";
 /** Chronologically ordered immutable history entries in this episode. */
-entries: [HistoryEntry, ...HistoryEntry[]];
+entries:[HistoryEntry,...HistoryEntry[]];
 /** Deterministically ordered nested episodes. */
-children: AgentEpisodeGroup[];
+children:AgentEpisodeGroup[];
 }
 /** Resolve the declared or deterministic legacy identity for one history event. */
-export declare function resolveHistoryEpisodeGroupIdentity(entry: HistoryEntry): Pick<AgentEpisodeGroup, "id" | "source">;
+export declare function resolveHistoryEpisodeGroupIdentity(entry:HistoryEntry):Pick<AgentEpisodeGroup,"id" | "source">;
 /**
  * Derive dimension coverage from descriptor data. Optional inputs make this a
  * usable negative-control gate instead of a hard-coded assertion.
  */
-export declare function analyzeAgentProvenanceDescriptorCoverage(descriptors?: readonly HarnessSignalDescriptor[], dimensions?: readonly string[]): AgentProvenanceDescriptorCoverage[];
+export declare function analyzeAgentProvenanceDescriptorCoverage(descriptors?:readonly HarnessSignalDescriptor[],dimensions?:readonly string[]):AgentProvenanceDescriptorCoverage[];
 /**
  * Summarize explicit model availability without consulting telemetry or
  * mutable item state. Legacy omissions remain distinct from unavailable.
  */
-export declare function summarizeAgentModelProvenance(entries: readonly Pick<HistoryEntry, "agent_harness" | "agent_model" | "agent_provenance">[], minimumExplicitSample?: number): AgentModelProvenanceCoverage[];
+export declare function summarizeAgentModelProvenance(entries:readonly Pick<HistoryEntry,"agent_harness" | "agent_model" | "agent_provenance">[],minimumExplicitSample?:number):AgentModelProvenanceCoverage[];
 /**
  * Summarize observed, explicitly unavailable, and legacy-missing values for
  * every requested provenance dimension without consulting mutable state.
  */
-export declare function summarizeAgentProvenance(entries: readonly Pick<HistoryEntry, "agent_harness" | "agent_model" | "agent_provenance">[], dimensions?: readonly string[], minimumExplicitSample?: number): AgentProvenanceDimensionCoverage[];
+export declare function summarizeAgentProvenance(entries:readonly Pick<HistoryEntry,"agent_harness" | "agent_model" | "agent_provenance">[],dimensions?:readonly string[],minimumExplicitSample?:number):AgentProvenanceDimensionCoverage[];
 /**
  * Measure role/topic availability by harness and precedence source, then apply
  * an explicit ratchet. Empty or synthetic corpora therefore remain useful
  * negative controls instead of silently passing a production coverage gate.
  */
-export declare function evaluateSemanticAttributionCoverage(entries: readonly Pick<HistoryEntry, "agent_harness" | "agent_provenance">[], options?: {
-minimumCoverage?: number;
-minimumEntries?: number;
-}): AgentSemanticAttributionCoverageGate;
+export declare function evaluateSemanticAttributionCoverage(entries:readonly Pick<HistoryEntry,"agent_harness" | "agent_provenance">[],options?:{
+minimumCoverage?:number;
+minimumEntries?:number;
+}):AgentSemanticAttributionCoverageGate;
 /**
  * Group immutable history by declared episode keys. Legacy entries fall back
  * to their privacy-safe agent instance, or to a deterministic author cohort.
  */
-export declare function groupHistoryByEpisode(entries: readonly HistoryEntry[]): AgentEpisodeGroup[];
+export declare function groupHistoryByEpisode(entries:readonly HistoryEntry[]):AgentEpisodeGroup[];