@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -10,112 +10,112 @@ export declare const MAX_WORKFLOW_POLICY_TERMS = 64;
 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[];
-    /** At least one of these exact tags must be present. */
-    tags?: string[];
-    /** Canonical target lifecycle statuses; deletion uses the previous status. */
-    statuses?: string[];
-    /** Exact mutation operation names, as recorded in history. */
-    operations?: string[];
-    /** Direct parent ids for scoping policies to a domain or programme. */
-    parents?: string[];
-    /** Outgoing edge requirement evaluated on the selected record. */
-    dependency?: {
-        kind: string;
-        id?: string;
-    };
+/** Case-insensitive item type names. */
+types?: string[];
+/** At least one of these exact tags must be present. */
+tags?: string[];
+/** Canonical target lifecycle statuses; deletion uses the previous status. */
+statuses?: string[];
+/** Exact mutation operation names, as recorded in history. */
+operations?: string[];
+/** Direct parent ids for scoping policies to a domain or programme. */
+parents?: string[];
+/** Outgoing edge requirement evaluated on the selected record. */
+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;
-    /** Human explanation of the invariant, at most 500 characters. */
-    description?: string;
-    /** Optional intersection of item and operation selectors. */
-    subject?: WorkflowPolicySubject;
-    /** Defaults to advise; refuse also requires document.enforcement=refuse. */
-    effect?: WorkflowPolicyEffect;
-    /** The requirement evaluated for matching mutations. */
-    rule: WorkflowPolicyRule;
+/** Stable declaration id retained in mutation evidence. */
+id: string;
+/** Human explanation of the invariant, at most 500 characters. */
+description?: string;
+/** Optional intersection of item and operation selectors. */
+subject?: WorkflowPolicySubject;
+/** Defaults to advise; refuse also requires document.enforcement=refuse. */
+effect?: WorkflowPolicyEffect;
+/** The requirement evaluated for matching mutations. */
+rule: WorkflowPolicyRule;
 }
 /** Versioned workspace data stored in schema/policies.json. */
 export interface WorkflowPolicyDocument {
-    /** Version of the declaration semantics. */
-    version: 1;
-    /** Explicit workspace permission for policies to refuse mutations. */
-    enforcement: "advise" | "refuse";
-    /** Ordered, uniquely identified declarations. */
-    policies: WorkflowPolicy[];
+/** Version of the declaration semantics. */
+version: 1;
+/** Explicit workspace permission for policies to refuse mutations. */
+enforcement: "advise" | "refuse";
+/** Ordered, uniquely identified declarations. */
+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;
-    /** Hash of the declared approval fields and item id. */
-    content_fingerprint: string;
-    /** Recorded author of the approval event. */
-    author: string;
+/** Exact policy declaration hash, including its selectors and effect. */
+policy_fingerprint: string;
+/** Hash of the declared approval fields and item id. */
+content_fingerprint: string;
+/** Recorded author of the approval event. */
+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;
-    /** Effective mutation actor; never taken from mutable item.author. */
-    author: string;
-    /** Previous record or null for creation. */
-    before: Readonly<Record<string, unknown>> | null;
-    /** Proposed record or null for deletion. */
-    after: Readonly<Record<string, unknown>> | null;
-    /** Verified approval events, omitted when no approval rule is applicable. */
-    approvals?: readonly WorkflowPolicyApproval[];
-    /** Inspect present fields using only require_fields rules without operation selectors. */
-    completeness_only?: boolean;
+/** History operation being evaluated; ignored by state-only completeness. */
+operation: string;
+/** Effective mutation actor; never taken from mutable item.author. */
+author: string;
+/** Previous record or null for creation. */
+before: Readonly<Record<string, unknown>> | null;
+/** Proposed record or null for deletion. */
+after: Readonly<Record<string, unknown>> | null;
+/** Verified approval events, omitted when no approval rule is applicable. */
+approvals?: readonly WorkflowPolicyApproval[];
+/** Inspect present fields using only require_fields rules without operation selectors. */
+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;
-    /** Fingerprint needed to identify the precise rule revision. */
-    policy_fingerprint: string;
-    /** Requirement vocabulary entry. */
-    rule: WorkflowPolicyRule["kind"];
-    /** Effective response after applying workspace consent. */
-    effect: WorkflowPolicyEffect;
-    /** Whether the proposed record meets this requirement. */
-    satisfied: boolean;
-    /** Missing field paths, never their values. */
-    missing_fields: string[];
-    /** Corrective action without item content or credential values. */
-    remediation: string;
+/** Stable id of the declaration evaluated. */
+policy_id: string;
+/** Fingerprint needed to identify the precise rule revision. */
+policy_fingerprint: string;
+/** Requirement vocabulary entry. */
+rule: WorkflowPolicyRule["kind"];
+/** Effective response after applying workspace consent. */
+effect: WorkflowPolicyEffect;
+/** Whether the proposed record meets this requirement. */
+satisfied: boolean;
+/** Missing field paths, never their values. */
+missing_fields: string[];
+/** Corrective action without item content or credential values. */
+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;
-    /** One result for every matched declaration. */
-    decisions: WorkflowPolicyDecision[];
-    /** Safe compact warnings for unsatisfied advisory requirements. */
-    warnings: string[];
+/** False when at least one effective refusal is unsatisfied. */
+allowed: boolean;
+/** One result for every matched declaration. */
+decisions: WorkflowPolicyDecision[];
+/** Safe compact warnings for unsatisfied advisory requirements. */
+warnings: string[];
 }
 /** Parse and normalize a declaration, rejecting unsupported selectors. */
 export declare function parseWorkflowPolicy(value: unknown): WorkflowPolicy;

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

@@ -1,52 +1,52 @@
 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;
-    /** Number of custom statuses. */
-    statuses: number;
-    /** Number of custom fields. */
-    fields: number;
-    /** Number of per-type workflows. */
-    workflows: number;
-    /** Number of config knobs. */
-    config: number;
-    /** Number of create templates. */
-    templates: number;
-    /** Number of recommended packages. */
-    packages: number;
+/** Number of item types the profile registers. */
+types: number;
+/** Number of custom statuses. */
+statuses: number;
+/** Number of custom fields. */
+fields: number;
+/** Number of per-type workflows. */
+workflows: number;
+/** Number of config knobs. */
+config: number;
+/** Number of create templates. */
+templates: number;
+/** Number of recommended packages. */
+packages: number;
 }
 /** A package recommendation distilled to its spec and rationale. */
 export interface ProjectProfilePackageSummary {
-    /** Catalog alias or install spec. */
-    spec: string;
-    /** Why the archetype benefits from the package. */
-    reason: string;
+/** Catalog alias or install spec. */
+spec: string;
+/** Why the archetype benefits from the package. */
+reason: string;
 }
 /** Deterministic summary of a profile's composition produced by {@link describeProjectProfile}. */
 export interface ProjectProfileDescription {
-    /** Profile name. */
-    name: string;
-    /** Display title. */
-    title: string;
-    /** One-line archetype summary. */
-    summary: string;
-    /** Per-dimension counts. */
-    composition: ProjectProfileComposition;
-    /** Canonical item type names the profile registers. */
-    types: string[];
-    /** Custom status ids. */
-    statuses: string[];
-    /** Custom field keys. */
-    fields: string[];
-    /** Item types governed by a staged workflow. */
-    workflows: string[];
-    /** Config knobs as `key=value` pairs. */
-    config: string[];
-    /** Template names the profile stages. */
-    templates: string[];
-    /** Recommended package specs with rationale. */
-    packages: ProjectProfilePackageSummary[];
+/** Profile name. */
+name: string;
+/** Display title. */
+title: string;
+/** One-line archetype summary. */
+summary: string;
+/** Per-dimension counts. */
+composition: ProjectProfileComposition;
+/** Canonical item type names the profile registers. */
+types: string[];
+/** Custom status ids. */
+statuses: string[];
+/** Custom field keys. */
+fields: string[];
+/** Item types governed by a staged workflow. */
+workflows: string[];
+/** Config knobs as `key=value` pairs. */
+config: string[];
+/** Template names the profile stages. */
+templates: string[];
+/** Recommended package specs with rationale. */
+packages: ProjectProfilePackageSummary[];
 }
 /** Computes the per-dimension counts for a profile. */
 export declare function describeProfileComposition(profile: ProjectProfileDefinition): ProjectProfileComposition;

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

@@ -11,29 +11,29 @@ export declare const PROFILE_LINT_CODES: readonly ["profile_name_empty", "profil
 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;
-    /** Stable machine-readable classification. */
-    code: ProfileLintCode;
-    /** Profile dimension the finding belongs to. */
-    dimension: ProfileLintDimension;
-    /** Identifier of the offending entry within the dimension, when applicable. */
-    target?: string;
-    /** Human-facing description of the problem. */
-    message: string;
+/** Whether the finding blocks a clean apply (`error`) or merely flags risk (`warning`). */
+severity: ProfileLintSeverity;
+/** Stable machine-readable classification. */
+code: ProfileLintCode;
+/** Profile dimension the finding belongs to. */
+dimension: ProfileLintDimension;
+/** Identifier of the offending entry within the dimension, when applicable. */
+target?: string;
+/** Human-facing description of the problem. */
+message: string;
 }
 /** Result of linting a single {@link ProjectProfileDefinition}. */
 export interface ProjectProfileLintReport {
-    /** The profile name as authored (preserved verbatim, even when blank). */
-    profile: string;
-    /** True when no `error`-severity findings were produced. */
-    ok: boolean;
-    /** All findings in deterministic dimension order. */
-    findings: ProjectProfileLintFinding[];
-    /** Count of `error`-severity findings. */
-    errorCount: number;
-    /** Count of `warning`-severity findings. */
-    warningCount: number;
+/** The profile name as authored (preserved verbatim, even when blank). */
+profile: string;
+/** True when no `error`-severity findings were produced. */
+ok: boolean;
+/** All findings in deterministic dimension order. */
+findings: ProjectProfileLintFinding[];
+/** Count of `error`-severity findings. */
+errorCount: number;
+/** Count of `warning`-severity findings. */
+warningCount: number;
 }
 /**
  * Lints a project profile definition for internal consistency, returning every

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

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