@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/extensions/activation-summary-markdown.js

@@ -1,146 +1,3 @@
-/**
- * The lowest and highest ATX heading levels Markdown supports, used to validate
- * {@link ExtensionSurfaceMarkdownOptions.headingLevel} and to clamp nested
- * section headings so a deep title never emits an invalid `#######` run.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="48c3e62a-8085-5215-a692-4c03792022ce")}catch(e){}}();
-const MIN_HEADING_LEVEL = 1;
-const MAX_HEADING_LEVEL = 6;
-/**
- * A surface section paired with the {@link ExtensionActivationSummary} field
- * whose identifiers populate it. Ordered for an author-facing reference:
- * commands first, then schema, then importers/exporters, retrieval, lifecycle
- * hooks, and finally the override surfaces. {@link ExtensionActivationSummary.command_handlers}
- * is intentionally omitted — it is a documented superset of `commands` plus the
- * synthesized `<name> import`/`<name> export` paths already covered by the
- * Importers and Exporters sections, so rendering it would duplicate information.
- */
-const SURFACE_SECTIONS = [
-    ["commands", "Commands"],
-    ["command_overrides", "Command overrides"],
-    ["flag_commands", "Flag commands"],
-    ["item_types", "Item types"],
-    ["item_fields", "Item fields"],
-    ["migrations", "Migrations"],
-    ["profiles", "Profiles"],
-    ["importers", "Importers"],
-    ["exporters", "Exporters"],
-    ["search_providers", "Search providers"],
-    ["vector_store_adapters", "Vector store adapters"],
-    ["assurance_providers", "Assurance measurement providers"],
-    ["hooks", "Lifecycle hooks"],
-    ["parser_overrides", "Parser overrides"],
-    ["service_overrides", "Service overrides"],
-    ["renderer_overrides", "Renderer overrides"],
-];
-/** Repeat `#` `level` times to form an ATX heading prefix. */
-function headingPrefix(level) {
-    return "#".repeat(level);
-}
-/** Render `value` as an inline Markdown code span. Backslash escapes do not work inside CommonMark code spans, so when `value` contains backticks the span is delimited by a run of backticks one longer than the longest internal run, and padded with a space when the value borders a backtick — the CommonMark rule for embedding literal backticks in a code span. */
-function code(value) {
-    if (!value.includes("`")) {
-        return `\`${value}\``;
-    }
-    let longestRun = 0;
-    let currentRun = 0;
-    for (const char of value) {
-        currentRun = char === "`" ? currentRun + 1 : 0;
-        longestRun = Math.max(longestRun, currentRun);
-    }
-    const fence = "`".repeat(longestRun + 1);
-    const pad = value.startsWith("`") || value.endsWith("`") ? " " : "";
-    return `${fence}${pad}${value}${pad}${fence}`;
-}
-/** Render the comma-separated capabilities summary line (or `_none registered_` when the activation exercised no known capability). */
-function renderCapabilitiesLine(capabilities) {
-    if (capabilities.length === 0) {
-        return "Capabilities: _none registered_";
-    }
-    return `Capabilities: ${capabilities.map(code).join(", ")}`;
-}
-/**
- * Render one surface section as `heading` + a bullet per identifier, or, when
- * `entries` is empty, `heading` + `_None._`. Callers decide whether an empty
- * section is rendered at all via {@link ExtensionSurfaceMarkdownOptions.includeEmpty}.
- */
-function renderSection(heading, level, entries) {
-    const lines = [`${headingPrefix(level)} ${heading}`, ""];
-    if (entries.length === 0) {
-        lines.push("_None._", "");
-        return lines;
-    }
-    lines.push(...entries.map((entry) => `- ${code(entry)}`), "");
-    return lines;
-}
-/**
- * Render the preflight-overrides section: a count line when any are registered,
- * `_None._` when {@link ExtensionSurfaceMarkdownOptions.includeEmpty} forces the
- * empty section, or no lines at all otherwise. Preflight overrides carry no
- * per-entry identifier, so they have a bespoke renderer rather than reusing
- * {@link renderSection}.
- */
-function renderPreflightSection(count, level, includeEmpty) {
-    if (count === 0 && !includeEmpty) {
-        return [];
-    }
-    return [
-        `${headingPrefix(level)} Preflight overrides`,
-        "",
-        count > 0
-            ? `- ${count} registered (this surface carries no per-entry identifier)`
-            : "_None._",
-        "",
-    ];
-}
-/**
- * Render an {@link ExtensionActivationSummary} as a deterministic Markdown
- * reference document.
- *
- * The output is a title heading, a one-line capabilities summary, and a section
- * per registered surface (commands, overrides, flags, item types/fields,
- * migrations, importers/exporters, search providers, vector adapters, lifecycle
- * hooks, and the parser/service/renderer override surfaces), followed by a
- * preflight-override count line when any are registered. Section order and
- * within-section identifier order both come straight from the summary, so the
- * same summary always renders byte-for-byte the same document.
- *
- * By default empty sections are omitted so the reference lists only what the
- * package contributes; set {@link ExtensionSurfaceMarkdownOptions.includeEmpty}
- * to render every section. A summary with no surfaces at all renders the title,
- * the capabilities line, and a `_This extension registers no surfaces._` note.
- *
- * @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.
- */
-export function renderExtensionSurfaceMarkdown(summary, options = {}) {
-    const titleLevel = options.headingLevel ?? 2;
-    if (!Number.isInteger(titleLevel) ||
-        titleLevel < MIN_HEADING_LEVEL ||
-        titleLevel > MAX_HEADING_LEVEL) {
-        throw new RangeError(`headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`);
-    }
-    const sectionLevel = Math.min(titleLevel + 1, MAX_HEADING_LEVEL);
-    const includeEmpty = options.includeEmpty === true;
-    const title = options.title ?? "Extension surfaces";
-    const lines = [`${headingPrefix(titleLevel)} ${title}`, ""];
-    if (includeEmpty || summary.capabilities.length > 0) {
-        lines.push(renderCapabilitiesLine(summary.capabilities), "");
-    }
-    for (const [field, heading] of SURFACE_SECTIONS) {
-        const entries = summary[field] ?? [];
-        if (entries.length === 0 && !includeEmpty) {
-            continue;
-        }
-        lines.push(...renderSection(heading, sectionLevel, entries));
-    }
-    lines.push(...renderPreflightSection(summary.preflight_overrides, sectionLevel, includeEmpty));
-    const hasAnySurface = summary.preflight_overrides > 0 ||
-        SURFACE_SECTIONS.some(([field]) => (summary[field]?.length ?? 0) > 0);
-    if (!hasAnySurface && !includeEmpty) {
-        lines.push("_This extension registers no surfaces._", "");
-    }
-    return `${lines.join("\n").trimEnd()}\n`;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2bc00b8e-0d9f-5af8-9667-d46136ff52b0")}catch(e2){}})();const MIN_HEADING_LEVEL=1;const MAX_HEADING_LEVEL=6;const SURFACE_SECTIONS=[["commands","Commands"],["command_overrides","Command overrides"],["flag_commands","Flag commands"],["item_types","Item types"],["item_fields","Item fields"],["migrations","Migrations"],["profiles","Profiles"],["importers","Importers"],["exporters","Exporters"],["search_providers","Search providers"],["vector_store_adapters","Vector store adapters"],["assurance_providers","Assurance measurement providers"],["hooks","Lifecycle hooks"],["parser_overrides","Parser overrides"],["service_overrides","Service overrides"],["renderer_overrides","Renderer overrides"]];function headingPrefix(level){return"#".repeat(level)}function code(value){if(!value.includes("`")){return`\`${value}\``}let longestRun=0;let currentRun=0;for(const char of value){currentRun=char==="`"?currentRun+1:0;longestRun=Math.max(longestRun,currentRun)}const fence="`".repeat(longestRun+1);const pad=value.startsWith("`")||value.endsWith("`")?" ":"";return`${fence}${pad}${value}${pad}${fence}`}function renderCapabilitiesLine(capabilities){if(capabilities.length===0){return"Capabilities: _none registered_"}return`Capabilities: ${capabilities.map(code).join(", ")}`}function renderSection(heading,level,entries){const lines=[`${headingPrefix(level)} ${heading}`,""];if(entries.length===0){lines.push("_None._","");return lines}lines.push(...entries.map(entry=>`- ${code(entry)}`),"");return lines}function renderPreflightSection(count,level,includeEmpty){if(count===0&&!includeEmpty){return[]}return[`${headingPrefix(level)} Preflight overrides`,"",count>0?`- ${count} registered (this surface carries no per-entry identifier)`:"_None._",""]}function renderExtensionSurfaceMarkdown(summary,options={}){const titleLevel=options.headingLevel??2;if(!Number.isInteger(titleLevel)||titleLevel<MIN_HEADING_LEVEL||titleLevel>MAX_HEADING_LEVEL){throw new RangeError(`headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`)}const sectionLevel=Math.min(titleLevel+1,MAX_HEADING_LEVEL);const includeEmpty=options.includeEmpty===true;const title=options.title??"Extension surfaces";const lines=[`${headingPrefix(titleLevel)} ${title}`,""];if(includeEmpty||summary.capabilities.length>0){lines.push(renderCapabilitiesLine(summary.capabilities),"")}for(const[field,heading]of SURFACE_SECTIONS){const entries=summary[field]??[];if(entries.length===0&&!includeEmpty){continue}lines.push(...renderSection(heading,sectionLevel,entries))}lines.push(...renderPreflightSection(summary.preflight_overrides,sectionLevel,includeEmpty));const hasAnySurface=summary.preflight_overrides>0||SURFACE_SECTIONS.some(([field])=>(summary[field]?.length??0)>0);if(!hasAnySurface&&!includeEmpty){lines.push("_This extension registers no surfaces._","")}return`${lines.join("\n").trimEnd()}
+`}export{renderExtensionSurfaceMarkdown};
 //# sourceMappingURL=activation-summary-markdown.js.map
-//# debugId=48c3e62a-8085-5215-a692-4c03792022ce

package/dist/core/extensions/activation-summary.js

@@ -1,93 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2c514907-377f-59f9-bfdd-a184abf7ffb7")}catch(e){}}();
-import { collectUsedExtensionCapabilities, normalizeExtensionName, } from "./capability-usage.js";
-/**
- * Canonical lifecycle hook kinds paired with their {@link ExtensionHookRegistry}
- * field, ordered to match `ExtensionActivationResult.hook_counts` so a summary's
- * `hooks` list reads in the same stable order the runtime reports counts in.
- */
-const HOOK_REGISTRY_FIELD_TO_KIND = [
-    ["beforeCommand", "before_command"],
-    ["beforeMutation", "before_mutation"],
-    ["afterCommand", "after_command"],
-    ["onWrite", "on_write"],
-    ["onRead", "on_read"],
-    ["onIndex", "on_index"],
-];
-/**
- * Summarize, by name, every registration surface an activation exercised.
- *
- * Walks the same sub-registries the loader populates and the capability
- * reconciler attributes, returning a flat {@link ExtensionActivationSummary}
- * whose arrays are sorted and de-duplicated. With
- * {@link DescribeExtensionActivationOptions.extensionName} only the matching
- * extension's registrations contribute (across both layers); without it the
- * summary unions every extension in the activation. Failed activations register
- * nothing, so they contribute only an empty summary.
- */
-export function describeExtensionActivation(activation, options = {}) {
-    // Match both sides with the same normalizer collectUsedExtensionCapabilities
-    // uses for the `capabilities` field below, so a filtered summary's named
-    // surfaces and capabilities never disagree for a stored name with whitespace.
-    const filters = new Set();
-    if (options.extensionName !== undefined) {
-        filters.add(normalizeExtensionName(options.extensionName));
-    }
-    for (const name of options.extensionNames ?? []) {
-        filters.add(normalizeExtensionName(name));
-    }
-    const matches = (name) => filters.size === 0 || filters.has(normalizeExtensionName(name));
-    const collect = (entries, identify) => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));
-    const collectFlat = (entries, expand) => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));
-    const { registrations, commands, parsers, preflight, services, renderers, hooks, } = activation;
-    // Preserve compatibility with activation payloads produced before this registry existed.
-    const relationshipKinds = collectFlat(registrations.relationship_kinds ?? [], (entry) => entry.definitions.map((definition) => definition.kind));
-    const rendererOwnership = renderers.overrides
-        .filter((entry) => matches(entry.name) &&
-        ((entry.commands?.length ?? 0) > 0 ||
-            entry.resultDiscriminator !== undefined))
-        .map((entry) => ({
-        format: entry.format,
-        commands: [...(entry.commands ?? [])],
-        result_discriminator: entry.resultDiscriminator !== undefined,
-    }))
-        .sort((left, right) => left.format.localeCompare(right.format));
-    const assuranceProviders = collect(registrations.assurance_providers ?? [], (entry) => entry.definition.id);
-    return {
-        capabilities: collectUsedExtensionCapabilities(activation, options),
-        commands: collect(registrations.commands, (entry) => entry.command),
-        command_overrides: collect(commands.overrides, (entry) => entry.command),
-        command_handlers: collect(commands.handlers, (entry) => entry.command),
-        hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(([, kind]) => kind),
-        flag_commands: collect(registrations.flags, (entry) => entry.target_command),
-        item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),
-        item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),
-        ...(relationshipKinds.length > 0
-            ? { relationship_kinds: relationshipKinds }
-            : {}),
-        migrations: collectFlat(registrations.migrations, (entry) => typeof entry.definition.id === "string" ? [entry.definition.id] : []),
-        profiles: collect(registrations.profiles, (entry) => entry.profile.name),
-        importers: collect(registrations.importers, (entry) => entry.importer),
-        exporters: collect(registrations.exporters, (entry) => entry.exporter),
-        search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),
-        vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),
-        ...(assuranceProviders.length > 0
-            ? { assurance_providers: assuranceProviders }
-            : {}),
-        parser_overrides: collect(parsers.overrides, (entry) => entry.command),
-        service_overrides: collect(services.overrides, (entry) => entry.service),
-        renderer_overrides: collect(renderers.overrides, (entry) => entry.format),
-        ...(rendererOwnership.length > 0
-            ? { renderer_ownership: rendererOwnership }
-            : {}),
-        preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length,
-        preflight_ownership: preflight.overrides
-            .filter((entry) => matches(entry.name))
-            .map((entry) => ({ commands: [...(entry.commands ?? [])] })),
-    };
-}
-function sortUnique(values) {
-    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f7999053-cf48-5588-b8c8-570789086dac")}catch(e2){}})();import{collectUsedExtensionCapabilities,normalizeExtensionName}from"./capability-usage.js";const HOOK_REGISTRY_FIELD_TO_KIND=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function describeExtensionActivation(activation,options={}){const filters=new Set;if(options.extensionName!==void 0){filters.add(normalizeExtensionName(options.extensionName))}for(const name of options.extensionNames??[]){filters.add(normalizeExtensionName(name))}const matches=name=>filters.size===0||filters.has(normalizeExtensionName(name));const collect=(entries,identify)=>sortUnique(entries.filter(entry=>matches(entry.name)).map(identify));const collectFlat=(entries,expand)=>sortUnique(entries.filter(entry=>matches(entry.name)).flatMap(expand));const{registrations,commands,parsers,preflight,services,renderers,hooks}=activation;const relationshipKinds=collectFlat(registrations.relationship_kinds??[],entry=>entry.definitions.map(definition=>definition.kind));const rendererOwnership=renderers.overrides.filter(entry=>matches(entry.name)&&((entry.commands?.length??0)>0||entry.resultDiscriminator!==void 0)).map(entry=>({format:entry.format,commands:[...entry.commands??[]],result_discriminator:entry.resultDiscriminator!==void 0})).sort((left,right)=>left.format.localeCompare(right.format));const assuranceProviders=collect(registrations.assurance_providers??[],entry=>entry.definition.id);return{capabilities:collectUsedExtensionCapabilities(activation,options),commands:collect(registrations.commands,entry=>entry.command),command_overrides:collect(commands.overrides,entry=>entry.command),command_handlers:collect(commands.handlers,entry=>entry.command),hooks:HOOK_REGISTRY_FIELD_TO_KIND.filter(([field])=>hooks[field].some(entry=>matches(entry.name))).map(([,kind])=>kind),flag_commands:collect(registrations.flags,entry=>entry.target_command),item_types:collectFlat(registrations.item_types,entry=>entry.types.map(type=>type.name)),item_fields:collectFlat(registrations.item_fields,entry=>entry.fields.map(field=>field.name)),...relationshipKinds.length>0?{relationship_kinds:relationshipKinds}:{},migrations:collectFlat(registrations.migrations,entry=>typeof entry.definition.id==="string"?[entry.definition.id]:[]),profiles:collect(registrations.profiles,entry=>entry.profile.name),importers:collect(registrations.importers,entry=>entry.importer),exporters:collect(registrations.exporters,entry=>entry.exporter),search_providers:collect(registrations.search_providers,entry=>entry.definition.name),vector_store_adapters:collect(registrations.vector_store_adapters,entry=>entry.definition.name),...assuranceProviders.length>0?{assurance_providers:assuranceProviders}:{},parser_overrides:collect(parsers.overrides,entry=>entry.command),service_overrides:collect(services.overrides,entry=>entry.service),renderer_overrides:collect(renderers.overrides,entry=>entry.format),...rendererOwnership.length>0?{renderer_ownership:rendererOwnership}:{},preflight_overrides:preflight.overrides.filter(entry=>matches(entry.name)).length,preflight_ownership:preflight.overrides.filter(entry=>matches(entry.name)).map(entry=>({commands:[...entry.commands??[]]}))}}function sortUnique(values){return[...new Set(values)].sort((left,right)=>left.localeCompare(right))}export{describeExtensionActivation};
 //# sourceMappingURL=activation-summary.js.map
-//# debugId=2c514907-377f-59f9-bfdd-a184abf7ffb7

package/dist/core/extensions/activation-transaction.js

@@ -1,47 +1,2 @@
-/**
- * Return a rollback operation that restores every mutable registry to its
- * current length, making one extension activation atomic without cloning
- * handlers or user values.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1558713a-91ea-5eef-8426-d910e0b77045")}catch(e){}}();
-export function captureExtensionActivationRollback(state) {
-    const lengths = {
-        beforeCommand: state.hooks.beforeCommand.length,
-        beforeMutation: state.hooks.beforeMutation.length,
-        afterCommand: state.hooks.afterCommand.length,
-        onWrite: state.hooks.onWrite.length,
-        onRead: state.hooks.onRead.length,
-        onIndex: state.hooks.onIndex.length,
-        commandOverrides: state.commands.overrides.length,
-        commandHandlers: state.commands.handlers.length,
-        parserOverrides: state.parsers.overrides.length,
-        preflightOverrides: state.preflight.overrides.length,
-        serviceOverrides: state.services.overrides.length,
-        rendererOverrides: state.renderers.overrides.length,
-        registrations: Object.fromEntries(Object.entries(state.registrations).map(([key, value]) => [
-            key,
-            value.length,
-        ])),
-    };
-    return () => {
-        state.hooks.beforeCommand.length = lengths.beforeCommand;
-        state.hooks.beforeMutation.length = lengths.beforeMutation;
-        state.hooks.afterCommand.length = lengths.afterCommand;
-        state.hooks.onWrite.length = lengths.onWrite;
-        state.hooks.onRead.length = lengths.onRead;
-        state.hooks.onIndex.length = lengths.onIndex;
-        state.commands.overrides.length = lengths.commandOverrides;
-        state.commands.handlers.length = lengths.commandHandlers;
-        state.parsers.overrides.length = lengths.parserOverrides;
-        state.preflight.overrides.length = lengths.preflightOverrides;
-        state.services.overrides.length = lengths.serviceOverrides;
-        state.renderers.overrides.length = lengths.rendererOverrides;
-        for (const [key, length] of Object.entries(lengths.registrations)) {
-            state.registrations[key].length =
-                length;
-        }
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="44b86710-2d6f-57fe-912d-1cf7482a4f86")}catch(e2){}})();function captureExtensionActivationRollback(state){const lengths={beforeCommand:state.hooks.beforeCommand.length,beforeMutation:state.hooks.beforeMutation.length,afterCommand:state.hooks.afterCommand.length,onWrite:state.hooks.onWrite.length,onRead:state.hooks.onRead.length,onIndex:state.hooks.onIndex.length,commandOverrides:state.commands.overrides.length,commandHandlers:state.commands.handlers.length,parserOverrides:state.parsers.overrides.length,preflightOverrides:state.preflight.overrides.length,serviceOverrides:state.services.overrides.length,rendererOverrides:state.renderers.overrides.length,registrations:Object.fromEntries(Object.entries(state.registrations).map(([key,value])=>[key,value.length]))};return()=>{state.hooks.beforeCommand.length=lengths.beforeCommand;state.hooks.beforeMutation.length=lengths.beforeMutation;state.hooks.afterCommand.length=lengths.afterCommand;state.hooks.onWrite.length=lengths.onWrite;state.hooks.onRead.length=lengths.onRead;state.hooks.onIndex.length=lengths.onIndex;state.commands.overrides.length=lengths.commandOverrides;state.commands.handlers.length=lengths.commandHandlers;state.parsers.overrides.length=lengths.parserOverrides;state.preflight.overrides.length=lengths.preflightOverrides;state.services.overrides.length=lengths.serviceOverrides;state.renderers.overrides.length=lengths.rendererOverrides;for(const[key,length]of Object.entries(lengths.registrations)){state.registrations[key].length=length}}}export{captureExtensionActivationRollback};
 //# sourceMappingURL=activation-transaction.js.map
-//# debugId=1558713a-91ea-5eef-8426-d910e0b77045

package/dist/core/extensions/capability-usage.js

@@ -1,174 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a35f3cdc-810e-59bd-8408-03ce792db57f")}catch(e){}}();
-import { normalizeKnownExtensionCapability } from "./extension-capability-aliases.js";
-/**
- * Canonical map from each known extension capability to the human-readable
- * registration surfaces that exercise it.
- *
- * The `satisfies Record<ExtensionCapability, ...>` guard makes this exhaustive
- * at compile time: adding a capability to `KNOWN_EXTENSION_CAPABILITIES`
- * without giving it a registration surface here fails the build, which prevents
- * a capability that has *no* surface from being perpetually flagged as unused.
- */
-export const EXTENSION_CAPABILITY_REGISTRATION_SURFACES = {
-    commands: ["registerCommand", "command override", "command handler"],
-    renderers: ["registerRenderer"],
-    hooks: [
-        "hooks.beforeCommand",
-        "hooks.beforeMutation",
-        "hooks.afterCommand",
-        "hooks.onWrite",
-        "hooks.onRead",
-        "hooks.onIndex",
-    ],
-    schema: [
-        "registerFlags",
-        "registerItemFields",
-        "registerItemTypes",
-        "registerRelationshipKinds",
-        "registerMigration",
-        "registerProfile",
-    ],
-    importers: ["registerImporter", "registerExporter"],
-    search: ["registerSearchProvider", "registerVectorStoreAdapter"],
-    parser: ["registerParser"],
-    preflight: ["registerPreflight"],
-    services: ["registerService", "registerAssuranceMeasurementProvider"],
-};
-// `layer` is a closed enum (`"global" | "project"`) that never contains a
-// colon, so the first colon always separates the layer from the (possibly
-// colon-bearing) name — making the key collision-proof without serialization.
-const USAGE_KEY_SEPARATOR = ":";
-function usageKey(layer, name) {
-    return `${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`;
-}
-function usageKeyName(key) {
-    return key.slice(key.indexOf(USAGE_KEY_SEPARATOR) + 1);
-}
-/**
- * Canonical extension-name normalization (trim + lowercase) used to match an
- * `extensionName` filter against a registration's stored `name`.
- *
- * Activation stores `extension.name` verbatim — the synthetic test-activation
- * path (`activateExtensionForTest`) never trims it — so any helper that filters
- * by extension name must normalize both sides with this function to stay
- * consistent, including {@link ../extensions/activation-summary.js#describeExtensionActivation}.
- */
-export function normalizeExtensionName(name) {
-    return name.trim().toLowerCase();
-}
-function normalizeDeclaredCapabilities(capabilities) {
-    if (!Array.isArray(capabilities)) {
-        return [];
-    }
-    const known = new Set();
-    for (const capability of capabilities) {
-        // Unknown capabilities are reported by the separate unknown-capability
-        // diagnostic; reconciling them here would double-report a typo as "unused".
-        const normalized = normalizeKnownExtensionCapability(capability);
-        if (normalized !== null) {
-            known.add(normalized);
-        }
-    }
-    return [...known].sort((left, right) => left.localeCompare(right));
-}
-function attributeCapabilityUsage(activation) {
-    const usage = new Map();
-    const record = (entries, capability) => {
-        for (const entry of entries) {
-            const key = usageKey(entry.layer, entry.name);
-            let exercised = usage.get(key);
-            if (exercised === undefined) {
-                exercised = new Set();
-                usage.set(key, exercised);
-            }
-            exercised.add(capability);
-        }
-    };
-    const { registrations, commands, parsers, preflight, services, renderers, hooks, } = activation;
-    record(registrations.commands, "commands");
-    record(commands.overrides, "commands");
-    record(commands.handlers, "commands");
-    record(registrations.flags, "schema");
-    record(registrations.item_fields, "schema");
-    record(registrations.item_types, "schema");
-    // Preserve compatibility with activation payloads produced before this registry existed.
-    record(registrations.relationship_kinds ?? [], "schema");
-    record(registrations.migrations, "schema");
-    record(registrations.profiles, "schema");
-    record(registrations.importers, "importers");
-    record(registrations.exporters, "importers");
-    record(registrations.search_providers, "search");
-    record(registrations.vector_store_adapters, "search");
-    record(parsers.overrides, "parser");
-    record(preflight.overrides, "preflight");
-    record(services.overrides, "services");
-    record(registrations.assurance_providers ?? [], "services");
-    record(renderers.overrides, "renderers");
-    record(hooks.beforeCommand, "hooks");
-    record(hooks.beforeMutation, "hooks");
-    record(hooks.afterCommand, "hooks");
-    record(hooks.onWrite, "hooks");
-    record(hooks.onRead, "hooks");
-    record(hooks.onIndex, "hooks");
-    return usage;
-}
-/**
- * Collect the known capabilities exercised across an activation result.
- *
- * Without {@link CollectUsedExtensionCapabilitiesOptions.extensionName} the
- * result unions every extension in the activation; with it, only the matching
- * extension's registrations contribute (across both layers).
- */
-export function collectUsedExtensionCapabilities(activation, options = {}) {
-    const usage = attributeCapabilityUsage(activation);
-    const filters = new Set();
-    if (options.extensionName !== undefined) {
-        filters.add(normalizeExtensionName(options.extensionName));
-    }
-    for (const name of options.extensionNames ?? []) {
-        filters.add(normalizeExtensionName(name));
-    }
-    const used = new Set();
-    for (const [key, capabilities] of usage) {
-        if (filters.size > 0 && !filters.has(usageKeyName(key))) {
-            continue;
-        }
-        for (const capability of capabilities) {
-            used.add(capability);
-        }
-    }
-    return [...used].sort((left, right) => left.localeCompare(right));
-}
-/**
- * Reconcile each loaded extension's declared capabilities against what it
- * exercised during activation.
- *
- * Extensions with no known declared capabilities are skipped — there is nothing
- * to reconcile. The returned entries preserve every reconcilable extension even
- * when `unused` is empty so callers can report fully-minimal manifests too.
- */
-export function reconcileExtensionCapabilityUsage(loaded, activation) {
-    const usage = attributeCapabilityUsage(activation);
-    const reconciliations = [];
-    for (const extension of loaded) {
-        const declared = normalizeDeclaredCapabilities(extension.capabilities);
-        if (declared.length === 0) {
-            continue;
-        }
-        const exercised = usage.get(usageKey(extension.layer, extension.name)) ??
-            new Set();
-        const used = [...exercised].sort((left, right) => left.localeCompare(right));
-        const unused = declared.filter((capability) => !exercised.has(capability));
-        reconciliations.push({
-            layer: extension.layer,
-            name: extension.name,
-            declared,
-            used,
-            unused,
-        });
-    }
-    return reconciliations;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="71c44385-0182-50f8-8e05-3aeebfe57ad9")}catch(e2){}})();import{normalizeKnownExtensionCapability}from"./extension-capability-aliases.js";const EXTENSION_CAPABILITY_REGISTRATION_SURFACES={commands:["registerCommand","command override","command handler"],renderers:["registerRenderer"],hooks:["hooks.beforeCommand","hooks.beforeMutation","hooks.afterCommand","hooks.onWrite","hooks.onRead","hooks.onIndex"],schema:["registerFlags","registerItemFields","registerItemTypes","registerRelationshipKinds","registerMigration","registerProfile"],importers:["registerImporter","registerExporter"],search:["registerSearchProvider","registerVectorStoreAdapter"],parser:["registerParser"],preflight:["registerPreflight"],services:["registerService","registerAssuranceMeasurementProvider"]};const USAGE_KEY_SEPARATOR=":";function usageKey(layer,name){return`${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`}function usageKeyName(key){return key.slice(key.indexOf(USAGE_KEY_SEPARATOR)+1)}function normalizeExtensionName(name){return name.trim().toLowerCase()}function normalizeDeclaredCapabilities(capabilities){if(!Array.isArray(capabilities)){return[]}const known=new Set;for(const capability of capabilities){const normalized=normalizeKnownExtensionCapability(capability);if(normalized!==null){known.add(normalized)}}return[...known].sort((left,right)=>left.localeCompare(right))}function attributeCapabilityUsage(activation){const usage=new Map;const record=(entries,capability)=>{for(const entry of entries){const key=usageKey(entry.layer,entry.name);let exercised=usage.get(key);if(exercised===void 0){exercised=new Set;usage.set(key,exercised)}exercised.add(capability)}};const{registrations,commands,parsers,preflight,services,renderers,hooks}=activation;record(registrations.commands,"commands");record(commands.overrides,"commands");record(commands.handlers,"commands");record(registrations.flags,"schema");record(registrations.item_fields,"schema");record(registrations.item_types,"schema");record(registrations.relationship_kinds??[],"schema");record(registrations.migrations,"schema");record(registrations.profiles,"schema");record(registrations.importers,"importers");record(registrations.exporters,"importers");record(registrations.search_providers,"search");record(registrations.vector_store_adapters,"search");record(parsers.overrides,"parser");record(preflight.overrides,"preflight");record(services.overrides,"services");record(registrations.assurance_providers??[],"services");record(renderers.overrides,"renderers");record(hooks.beforeCommand,"hooks");record(hooks.beforeMutation,"hooks");record(hooks.afterCommand,"hooks");record(hooks.onWrite,"hooks");record(hooks.onRead,"hooks");record(hooks.onIndex,"hooks");return usage}function collectUsedExtensionCapabilities(activation,options={}){const usage=attributeCapabilityUsage(activation);const filters=new Set;if(options.extensionName!==void 0){filters.add(normalizeExtensionName(options.extensionName))}for(const name of options.extensionNames??[]){filters.add(normalizeExtensionName(name))}const used=new Set;for(const[key,capabilities]of usage){if(filters.size>0&&!filters.has(usageKeyName(key))){continue}for(const capability of capabilities){used.add(capability)}}return[...used].sort((left,right)=>left.localeCompare(right))}function reconcileExtensionCapabilityUsage(loaded,activation){const usage=attributeCapabilityUsage(activation);const reconciliations=[];for(const extension of loaded){const declared=normalizeDeclaredCapabilities(extension.capabilities);if(declared.length===0){continue}const exercised=usage.get(usageKey(extension.layer,extension.name))??new Set;const used=[...exercised].sort((left,right)=>left.localeCompare(right));const unused=declared.filter(capability=>!exercised.has(capability));reconciliations.push({layer:extension.layer,name:extension.name,declared,used,unused})}return reconciliations}export{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,normalizeExtensionName,reconcileExtensionCapabilityUsage};
 //# sourceMappingURL=capability-usage.js.map
-//# debugId=a35f3cdc-810e-59bd-8408-03ce792db57f

package/dist/core/extensions/command-hook-context.js

@@ -1,14 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="bd9832a9-f6a2-5351-a929-0a0d2766df88")}catch(e){}}();
-import { createEmptyExtensionHookRegistry } from "./extension-registries.js";
-/** Creates post-command runtime state for an invocation without extensions. */
-export function createCoreCommandHookContext(options) {
-    return {
-        ...options,
-        hooks: createEmptyExtensionHookRegistry(),
-        profileEnabled: Boolean(options.globalOptions.profile),
-        migrationBlockers: [],
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b2cf7f56-432d-5c74-ba0f-248c42a97255")}catch(e2){}})();import{createEmptyExtensionHookRegistry}from"./extension-registries.js";function createCoreCommandHookContext(options){return{...options,hooks:createEmptyExtensionHookRegistry(),profileEnabled:Boolean(options.globalOptions.profile),migrationBlockers:[]}}export{createCoreCommandHookContext};
 //# sourceMappingURL=command-hook-context.js.map
-//# debugId=bd9832a9-f6a2-5351-a929-0a0d2766df88

package/dist/core/extensions/command-metadata-contract.js

@@ -1,23 +1,2 @@
-/**
- * @module core/extensions/command-metadata-contract
- *
- * Owns the closed metadata domains shared by extension registration, runtime
- * validation, SDK contracts, and workspace projections.
- */
-/** Canonical capability-family values accepted for every command surface. */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b799a368-2a8a-5031-8d14-f6b9dc4a3978")}catch(e){}}();
-export const EXTENSION_COMMAND_CAPABILITY_FAMILIES = Object.freeze([
-    "workspace",
-    "intake",
-    "context",
-    "lifecycle",
-    "evidence",
-    "graph",
-    "quality",
-    "automation",
-    "extensions",
-    "internal",
-]);
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="34536eba-0f92-5599-a807-5b39b000e733")}catch(e2){}})();const EXTENSION_COMMAND_CAPABILITY_FAMILIES=Object.freeze(["workspace","intake","context","lifecycle","evidence","graph","quality","automation","extensions","internal"]);export{EXTENSION_COMMAND_CAPABILITY_FAMILIES};
 //# sourceMappingURL=command-metadata-contract.js.map
-//# debugId=b799a368-2a8a-5031-8d14-f6b9dc4a3978

package/dist/core/extensions/command-visibility-tier.js

@@ -1,30 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="764d9a7d-90a2-578f-ab5d-bd0c039596df")}catch(e){}}();
-import { assertOptionalStringField } from "./registration-validation.js";
-import { EXTENSION_COMMAND_CAPABILITY_FAMILIES } from "./command-metadata-contract.js";
-const COMMAND_CAPABILITY_FAMILIES = new Set(EXTENSION_COMMAND_CAPABILITY_FAMILIES);
-function assertCommandCapabilityFamily(family) {
-    if (family !== undefined &&
-        !COMMAND_CAPABILITY_FAMILIES.has(String(family))) {
-        throw new Error(`registerCommand definition.family must be one of: ${EXTENSION_COMMAND_CAPABILITY_FAMILIES.join(", ")}`);
-    }
-}
-/** Validate optional command metadata strings and the closed visibility tier. */
-export function assertCommandDefinitionMetadataStrings(definition) {
-    assertOptionalStringField("registerCommand definition.action", definition.action);
-    assertOptionalStringField("registerCommand definition.family", definition.family);
-    assertOptionalStringField("registerCommand definition.description", definition.description);
-    assertOptionalStringField("registerCommand definition.intent", definition.intent);
-    assertOptionalStringField("registerCommand definition.tier", definition.tier);
-    const tier = definition.tier;
-    if (tier !== undefined &&
-        tier !== "core" &&
-        tier !== "standard" &&
-        tier !== "full" &&
-        tier !== "internal") {
-        throw new Error("registerCommand definition.tier must be core, standard, full, or internal");
-    }
-    assertCommandCapabilityFamily(definition.family);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ca48c32a-e4e0-5da5-b9cb-b1f713646bad")}catch(e2){}})();import{assertOptionalStringField}from"./registration-validation.js";import{EXTENSION_COMMAND_CAPABILITY_FAMILIES}from"./command-metadata-contract.js";const COMMAND_CAPABILITY_FAMILIES=new Set(EXTENSION_COMMAND_CAPABILITY_FAMILIES);function assertCommandCapabilityFamily(family){if(family!==void 0&&!COMMAND_CAPABILITY_FAMILIES.has(String(family))){throw new Error(`registerCommand definition.family must be one of: ${EXTENSION_COMMAND_CAPABILITY_FAMILIES.join(", ")}`)}}function assertCommandDefinitionMetadataStrings(definition){assertOptionalStringField("registerCommand definition.action",definition.action);assertOptionalStringField("registerCommand definition.family",definition.family);assertOptionalStringField("registerCommand definition.description",definition.description);assertOptionalStringField("registerCommand definition.intent",definition.intent);assertOptionalStringField("registerCommand definition.tier",definition.tier);const tier=definition.tier;if(tier!==void 0&&tier!=="core"&&tier!=="standard"&&tier!=="full"&&tier!=="internal"){throw new Error("registerCommand definition.tier must be core, standard, full, or internal")}assertCommandCapabilityFamily(definition.family)}export{assertCommandDefinitionMetadataStrings};
 //# sourceMappingURL=command-visibility-tier.js.map
-//# debugId=764d9a7d-90a2-578f-ab5d-bd0c039596df