@unbrained/pm-cli 2026.10.14 → 2026.10.15

package/dist/core/policy/workflow-policy.d.ts

@@ -1,5 +1,5 @@
 /** Policy verbs carried under the existing schema command family. */
-export declare const WORKFLOW_POLICY_ACTIONS: readonly ["policies", "policy-put", "policy-remove", "policy-mode", "policy-check", "policy-approve", "policy-presets"];
+export declare const WORKFLOW_POLICY_ACTIONS:readonly ["policies","policy-put","policy-remove","policy-mode","policy-check","policy-approve","policy-presets"];
 /** Portable schema-policy action vocabulary. */
 export type WorkflowPolicyAction = (typeof WORKFLOW_POLICY_ACTIONS)[number];
 /** Maximum declarations evaluated for one mutation, independent of corpus size. */
@@ -11,129 +11,129 @@ export type WorkflowPolicyEffect = "advise" | "warn" | "refuse";
 /** All supplied selectors must match; values within a selector are alternatives. */
 export interface WorkflowPolicySubject {
 /** Case-insensitive item type names. */
-types?: string[];
+types?:string[];
 /** At least one of these exact tags must be present. */
-tags?: string[];
+tags?:string[];
 /** Canonical target lifecycle statuses; deletion uses the previous status. */
-statuses?: string[];
+statuses?:string[];
 /** Exact mutation operation names, as recorded in history. */
-operations?: string[];
+operations?:string[];
 /** Direct parent ids for scoping policies to a domain or programme. */
-parents?: string[];
+parents?:string[];
 /** Outgoing edge requirement evaluated on the selected record. */
-dependency?: {
-kind: string;
-id?: string;
+dependency?:{
+kind:string;
+id?:string;
 };
 }
 /** Data-only requirements; no expressions, regexes, or executable code. */
 export type WorkflowPolicyRule = {
-kind: "require_fields";
-fields: string[];
+kind:"require_fields";
+fields:string[];
 } | {
-kind: "transition";
-allowed: [string, string][];
+kind:"transition";
+allowed:[string,string][];
 } | {
-kind: "authors";
-authors: string[];
+kind:"authors";
+authors:string[];
 } | {
-kind: "field_writers";
-fields: string[];
-authors: string[];
+kind:"field_writers";
+fields:string[];
+authors:string[];
 } | {
-kind: "approval";
-fields: string[];
-authors: string[];
+kind:"approval";
+fields:string[];
+authors:string[];
 };
 /** One stable, explainable workflow requirement. */
 export interface WorkflowPolicy {
 /** Stable declaration id retained in mutation evidence. */
-id: string;
+id:string;
 /** Human explanation of the invariant, at most 500 characters. */
-description?: string;
+description?:string;
 /** Optional intersection of item and operation selectors. */
-subject?: WorkflowPolicySubject;
+subject?:WorkflowPolicySubject;
 /** Defaults to advise; refuse also requires document.enforcement=refuse. */
-effect?: WorkflowPolicyEffect;
+effect?:WorkflowPolicyEffect;
 /** The requirement evaluated for matching mutations. */
-rule: WorkflowPolicyRule;
+rule:WorkflowPolicyRule;
 }
 /** Versioned workspace data stored in schema/policies.json. */
 export interface WorkflowPolicyDocument {
 /** Version of the declaration semantics. */
-version: 1;
+version:1;
 /** Explicit workspace permission for policies to refuse mutations. */
-enforcement: "advise" | "refuse";
+enforcement:"advise" | "refuse";
 /** Ordered, uniquely identified declarations. */
-policies: WorkflowPolicy[];
+policies:WorkflowPolicy[];
 }
 /** Approval evidence resolved from a verified immutable item history. */
 export interface WorkflowPolicyApproval {
 /** Exact policy declaration hash, including its selectors and effect. */
-policy_fingerprint: string;
+policy_fingerprint:string;
 /** Hash of the declared approval fields and item id. */
-content_fingerprint: string;
+content_fingerprint:string;
 /** Recorded author of the approval event. */
-author: string;
+author:string;
 }
 /** Presentation-independent mutation snapshot. Body is a normal selectable field. */
 export interface WorkflowPolicyInput {
 /** History operation being evaluated; ignored by state-only completeness. */
-operation: string;
+operation:string;
 /** Effective mutation actor; never taken from mutable item.author. */
-author: string;
+author:string;
 /** Previous record or null for creation. */
-before: Readonly<Record<string, unknown>> | null;
+before:Readonly<Record<string,unknown>> | null;
 /** Proposed record or null for deletion. */
-after: Readonly<Record<string, unknown>> | null;
+after:Readonly<Record<string,unknown>> | null;
 /** Verified approval events, omitted when no approval rule is applicable. */
-approvals?: readonly WorkflowPolicyApproval[];
+approvals?:readonly WorkflowPolicyApproval[];
 /** Inspect present fields using only require_fields rules without operation selectors. */
-completeness_only?: boolean;
+completeness_only?:boolean;
 }
 /** Bounded explanation recorded alongside a mutation or returned by a preview. */
 export interface WorkflowPolicyDecision {
 /** Stable id of the declaration evaluated. */
-policy_id: string;
+policy_id:string;
 /** Fingerprint needed to identify the precise rule revision. */
-policy_fingerprint: string;
+policy_fingerprint:string;
 /** Requirement vocabulary entry. */
-rule: WorkflowPolicyRule["kind"];
+rule:WorkflowPolicyRule["kind"];
 /** Effective response after applying workspace consent. */
-effect: WorkflowPolicyEffect;
+effect:WorkflowPolicyEffect;
 /** Whether the proposed record meets this requirement. */
-satisfied: boolean;
+satisfied:boolean;
 /** Missing field paths, never their values. */
-missing_fields: string[];
+missing_fields:string[];
 /** Corrective action without item content or credential values. */
-remediation: string;
+remediation:string;
 }
 /** Complete decision set; callers may project it without weakening enforcement. */
 export interface WorkflowPolicyEvaluation {
 /** False when at least one effective refusal is unsatisfied. */
-allowed: boolean;
+allowed:boolean;
 /** One result for every matched declaration. */
-decisions: WorkflowPolicyDecision[];
+decisions:WorkflowPolicyDecision[];
 /** Safe compact warnings for unsatisfied advisory requirements. */
-warnings: string[];
+warnings:string[];
 }
 /** Parse and normalize a declaration, rejecting unsupported selectors. */
-export declare function parseWorkflowPolicy(value: unknown): WorkflowPolicy;
+export declare function parseWorkflowPolicy(value:unknown):WorkflowPolicy;
 /** Validate a complete registry; absence is handled by the IO layer, never malformed data. */
-export declare function parseWorkflowPolicyDocument(value: unknown): WorkflowPolicyDocument;
+export declare function parseWorkflowPolicyDocument(value:unknown):WorkflowPolicyDocument;
 /** Read only own properties so prototype values cannot satisfy a declared field. */
-export declare function readWorkflowPolicyField(record: Readonly<Record<string, unknown>> | null, field: string): unknown;
+export declare function readWorkflowPolicyField(record:Readonly<Record<string,unknown>> | null,field:string):unknown;
 /** Fingerprint exactly the declaration semantics used by a decision. */
-export declare function workflowPolicyFingerprint(policy: WorkflowPolicy): string;
+export declare function workflowPolicyFingerprint(policy:WorkflowPolicy):string;
 /** Bind an approval to its item and declared fields, excluding unrelated metadata. */
-export declare function workflowApprovalFingerprint(policy: WorkflowPolicy, record: Readonly<Record<string, unknown>>): string;
+export declare function workflowApprovalFingerprint(policy:WorkflowPolicy,record:Readonly<Record<string,unknown>>):string;
 /** Match both sides so removing a tag or changing type cannot evade a rule. */
-export declare function workflowPolicyApplies(policy: WorkflowPolicy, input: WorkflowPolicyInput): boolean;
+export declare function workflowPolicyApplies(policy:WorkflowPolicy,input:WorkflowPolicyInput):boolean;
 /** Evaluate current declarations; a later advisory can never override a refusal. */
-export declare function evaluateWorkflowPolicies(document: WorkflowPolicyDocument, input: WorkflowPolicyInput): WorkflowPolicyEvaluation;
+export declare function evaluateWorkflowPolicies(document:WorkflowPolicyDocument,input:WorkflowPolicyInput):WorkflowPolicyEvaluation;
 /**
  * Capture a private normalized declaration snapshot for repeated evaluation.
  * Each policy is hashed once; later edits to the caller's mutable document do
  * not alter this evaluator. Create another evaluator to adopt those edits.
  */
-export declare function createWorkflowPolicyEvaluator(document: WorkflowPolicyDocument): (input: WorkflowPolicyInput) => WorkflowPolicyEvaluation;
+export declare function createWorkflowPolicyEvaluator(document:WorkflowPolicyDocument):(input:WorkflowPolicyInput) => WorkflowPolicyEvaluation;

package/dist/core/profile/profile-describe.d.ts

@@ -2,54 +2,54 @@ import type { ProjectProfileDefinition } from "./profile-presets.js";
 /** Per-dimension counts summarizing how much a profile stages. */
 export interface ProjectProfileComposition {
 /** Number of item types the profile registers. */
-types: number;
+types:number;
 /** Number of custom statuses. */
-statuses: number;
+statuses:number;
 /** Number of custom fields. */
-fields: number;
+fields:number;
 /** Number of per-type workflows. */
-workflows: number;
+workflows:number;
 /** Number of config knobs. */
-config: number;
+config:number;
 /** Number of create templates. */
-templates: number;
+templates:number;
 /** Number of recommended packages. */
-packages: number;
+packages:number;
 }
 /** A package recommendation distilled to its spec and rationale. */
 export interface ProjectProfilePackageSummary {
 /** Catalog alias or install spec. */
-spec: string;
+spec:string;
 /** Why the archetype benefits from the package. */
-reason: string;
+reason:string;
 }
 /** Deterministic summary of a profile's composition produced by {@link describeProjectProfile}. */
 export interface ProjectProfileDescription {
 /** Profile name. */
-name: string;
+name:string;
 /** Display title. */
-title: string;
+title:string;
 /** One-line archetype summary. */
-summary: string;
+summary:string;
 /** Per-dimension counts. */
-composition: ProjectProfileComposition;
+composition:ProjectProfileComposition;
 /** Canonical 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: ProjectProfilePackageSummary[];
+packages:ProjectProfilePackageSummary[];
 }
 /** Computes the per-dimension counts for a profile. */
-export declare function describeProfileComposition(profile: ProjectProfileDefinition): ProjectProfileComposition;
+export declare function describeProfileComposition(profile:ProjectProfileDefinition):ProjectProfileComposition;
 /**
  * Distills a profile definition into a deterministic composition summary. Pure
  * and tracker-independent; the resolved identifiers match exactly what
@@ -59,4 +59,4 @@ export declare function describeProfileComposition(profile: ProjectProfileDefini
  * @returns The profile's metadata, per-dimension counts, and resolved entry
  *   identifiers.
  */
-export declare function describeProjectProfile(profile: ProjectProfileDefinition): ProjectProfileDescription;
+export declare function describeProjectProfile(profile:ProjectProfileDefinition):ProjectProfileDescription;

package/dist/core/profile/profile-lint.d.ts

@@ -2,38 +2,38 @@ import { type ProjectProfileDefinition } from "./profile-presets.js";
 /** Severity grade of a profile lint finding. */
 export type ProfileLintSeverity = "error" | "warning";
 /** Profile dimension a lint finding is attributed to. */
-export declare const PROFILE_LINT_DIMENSIONS: readonly ["profile", "types", "statuses", "fields", "workflows", "config", "templates", "packages"];
+export declare const PROFILE_LINT_DIMENSIONS:readonly ["profile","types","statuses","fields","workflows","config","templates","packages"];
 /** Restricts profile lint dimension values accepted by command, SDK, and storage contracts. */
 export type ProfileLintDimension = (typeof PROFILE_LINT_DIMENSIONS)[number];
 /** Stable machine-readable codes every {@link ProjectProfileLintFinding} carries. */
-export declare const PROFILE_LINT_CODES: readonly ["profile_name_empty", "profile_name_not_normalized", "profile_title_empty", "profile_summary_empty", "type_invalid", "type_duplicate", "status_invalid", "status_duplicate", "field_invalid", "field_duplicate", "field_mcp_input_collision", "workflow_type_empty", "workflow_type_unknown", "workflow_duplicate_type", "workflow_transition_malformed", "workflow_status_unknown", "config_key_unknown", "config_value_invalid", "config_duplicate", "template_type_unknown", "package_spec_empty"];
+export declare const PROFILE_LINT_CODES:readonly ["profile_name_empty","profile_name_not_normalized","profile_title_empty","profile_summary_empty","type_invalid","type_duplicate","status_invalid","status_duplicate","field_invalid","field_duplicate","field_mcp_input_collision","workflow_type_empty","workflow_type_unknown","workflow_duplicate_type","workflow_transition_malformed","workflow_status_unknown","config_key_unknown","config_value_invalid","config_duplicate","template_type_unknown","package_spec_empty"];
 /** Restricts profile lint code values accepted by command, SDK, and storage contracts. */
 export type ProfileLintCode = (typeof PROFILE_LINT_CODES)[number];
 /** A single graded consistency finding produced by {@link lintProjectProfile}. */
 export interface ProjectProfileLintFinding {
 /** Whether the finding blocks a clean apply (`error`) or merely flags risk (`warning`). */
-severity: ProfileLintSeverity;
+severity:ProfileLintSeverity;
 /** Stable machine-readable classification. */
-code: ProfileLintCode;
+code:ProfileLintCode;
 /** Profile dimension the finding belongs to. */
-dimension: ProfileLintDimension;
+dimension:ProfileLintDimension;
 /** Identifier of the offending entry within the dimension, when applicable. */
-target?: string;
+target?:string;
 /** Human-facing description of the problem. */
-message: string;
+message:string;
 }
 /** Result of linting a single {@link ProjectProfileDefinition}. */
 export interface ProjectProfileLintReport {
 /** The profile name as authored (preserved verbatim, even when blank). */
-profile: string;
+profile:string;
 /** True when no `error`-severity findings were produced. */
-ok: boolean;
+ok:boolean;
 /** All findings in deterministic dimension order. */
-findings: ProjectProfileLintFinding[];
+findings:ProjectProfileLintFinding[];
 /** Count of `error`-severity findings. */
-errorCount: number;
+errorCount:number;
 /** Count of `warning`-severity findings. */
-warningCount: number;
+warningCount:number;
 }
 /**
  * Lints a project profile definition for internal consistency, returning every
@@ -46,4 +46,4 @@ warningCount: number;
  * @returns A report whose `ok` flag is true exactly when no `error` findings
  *   were produced.
  */
-export declare function lintProjectProfile(profile: ProjectProfileDefinition): ProjectProfileLintReport;
+export declare function lintProjectProfile(profile:ProjectProfileDefinition):ProjectProfileLintReport;

package/dist/core/profile/profile-plan.d.ts

@@ -17,129 +17,129 @@ import { type ItemTypesFile } from "../schema/item-types-file.js";
 import { type StatusDefsFile } from "../schema/status-defs-file.js";
 import { type FieldsFile } from "../schema/fields-file.js";
 import type { TypeWorkflowDefinition } from "../../types.js";
-import type { ProfileTemplateOptions, ProjectProfileDefinition } from "./profile-presets.js";
+import type { ProfileTemplateOptions,ProjectProfileDefinition } from "./profile-presets.js";
 /** Per-entry change classification used across every profile dimension. */
 export type ProfileChangeStatus = "add" | "update" | "unchanged";
 /** A single staged change keyed by its component identifier. */
 export interface ProfileComponentChange {
 /** Component identity (type name, status id, field key, etc.). */
-key: string;
+key:string;
 /** Whether the entry is new, an overwrite, or already current. */
-status: ProfileChangeStatus;
+status:ProfileChangeStatus;
 }
 /** Plan for a file-backed schema component (types/statuses/fields). */
 export interface ProfileSchemaPlan<TFile> {
 /** Serialized file content to persist when `changed`. */
-file: TFile;
+file:TFile;
 /** Per-entry classifications in profile order. */
-changes: ProfileComponentChange[];
+changes:ProfileComponentChange[];
 /** True when at least one entry is add/update. */
-changed: boolean;
+changed:boolean;
 }
 /** A staged per-type workflow change plus the merged result list. */
 export interface ProfileWorkflowChange {
 /** Item type the workflow governs. */
-type: string;
+type:string;
 /** Whether the workflow is new, changed, or already current. */
-status: ProfileChangeStatus;
+status:ProfileChangeStatus;
 }
 /** Plan for the `schema.type_workflows` settings subtree. */
 export interface ProfileWorkflowPlan {
 /** Per-workflow classifications in profile order. */
-changes: ProfileWorkflowChange[];
+changes:ProfileWorkflowChange[];
 /** Full merged workflow list to persist when `changed`. */
-result: TypeWorkflowDefinition[];
+result:TypeWorkflowDefinition[];
 /** True when at least one workflow is add/update. */
-changed: boolean;
+changed:boolean;
 }
 /** A staged config knob plus the resolved settings path and typed value. */
 export interface ProfileConfigChange {
 /** Descriptor key (snake_case). */
-key: string;
+key:string;
 /** Dotted PmSettings path the value writes to. */
-path: string;
+path:string;
 /** Typed leaf value to persist. */
-value: string | number | boolean;
+value:string | number | boolean;
 /** Whether the leaf is new, changed, or already current. */
-status: ProfileChangeStatus;
+status:ProfileChangeStatus;
 }
 /** Plan for the nested-settings knobs a profile stages. */
 export interface ProfileConfigPlan {
 /** Per-knob classifications in profile order. */
-changes: ProfileConfigChange[];
+changes:ProfileConfigChange[];
 /** True when at least one knob is add/update. */
-changed: boolean;
+changed:boolean;
 }
 /** A staged create-template change. */
 export interface ProfileTemplateChange {
 /** Template name. */
-name: string;
+name:string;
 /** Option payload to persist for the template. */
-options: ProfileTemplateOptions;
+options:ProfileTemplateOptions;
 /** Whether the template is new, changed, or already current. */
-status: ProfileChangeStatus;
+status:ProfileChangeStatus;
 }
 /** Plan for the create templates a profile stages. */
 export interface ProfileTemplatePlan {
 /** Per-template classifications in profile order. */
-changes: ProfileTemplateChange[];
+changes:ProfileTemplateChange[];
 /** True when at least one template is add/update. */
-changed: boolean;
+changed:boolean;
 }
 /** Advisory package recommendation with install status. */
 export interface ProfilePackagePlan {
 /** Catalog alias or install spec. */
-spec: string;
+spec:string;
 /** Why the archetype benefits from the package. */
-reason: string;
+reason:string;
 /** `installed` when already present, otherwise `recommended`. */
-status: "installed" | "recommended";
+status:"installed" | "recommended";
 }
 /** Current tracker state the planner diffs the profile against. */
 export interface ProfileCurrentState {
 /** Raw `schema/types.json` content (or null when absent). */
-typesRaw: string | null;
+typesRaw:string | null;
 /** Raw status-defs file content (or null when absent). */
-statusesRaw: string | null;
+statusesRaw:string | null;
 /** Raw fields file content (or null when absent). */
-fieldsRaw: string | null;
+fieldsRaw:string | null;
 /** Current `schema.type_workflows` entries. */
-workflows: readonly TypeWorkflowDefinition[];
+workflows:readonly TypeWorkflowDefinition[];
 /** Settings object used to read current config leaf values. */
-settings: unknown;
+settings:unknown;
 /** Existing stored template options keyed by template name. */
-templates: ReadonlyMap<string, ProfileTemplateOptions>;
+templates:ReadonlyMap<string,ProfileTemplateOptions>;
 /** Install specs/aliases already present in the project. */
-installedPackages: ReadonlySet<string>;
+installedPackages:ReadonlySet<string>;
 }
 /** Complete idempotent plan for applying a profile. */
 export interface ProfileApplicationPlan {
 /** Identifying metadata for the planned profile. */
-profile: {
-name: string;
-title: string;
-summary: string;
+profile:{
+name:string;
+title:string;
+summary:string;
 };
 /** Item-type plan. */
-types: ProfileSchemaPlan<ItemTypesFile>;
+types:ProfileSchemaPlan<ItemTypesFile>;
 /** Status plan. */
-statuses: ProfileSchemaPlan<StatusDefsFile>;
+statuses:ProfileSchemaPlan<StatusDefsFile>;
 /** Field plan. */
-fields: ProfileSchemaPlan<FieldsFile>;
+fields:ProfileSchemaPlan<FieldsFile>;
 /** Per-type workflow plan. */
-workflows: ProfileWorkflowPlan;
+workflows:ProfileWorkflowPlan;
 /** Config-knob plan. */
-config: ProfileConfigPlan;
+config:ProfileConfigPlan;
 /** Template plan. */
-templates: ProfileTemplatePlan;
+templates:ProfileTemplatePlan;
 /** Advisory package recommendations. */
-packages: ProfilePackagePlan[];
+packages:ProfilePackagePlan[];
 /** True when any dimension stages an add/update. */
-changed: boolean;
+changed:boolean;
 }
 /**
  * Computes the complete idempotent application plan for a profile against the
  * supplied tracker snapshot. The returned files/settings are exactly what the
  * apply step persists; nothing here touches disk.
  */
-export declare function planProfileApplication(profile: ProjectProfileDefinition, current: ProfileCurrentState): ProfileApplicationPlan;
+export declare function planProfileApplication(profile:ProjectProfileDefinition,current:ProfileCurrentState):ProfileApplicationPlan;