@delorenj/skillex 0.2.0 → 0.3.0

package/dist/core/selection.d.ts

@@ -5,8 +5,6 @@ export interface SkillSelection {
 }
 export interface SetSelection {
     readonly name: string;
-    readonly include?: readonly string[];
-    readonly exclude: readonly string[];
     readonly optional: boolean;
 }
 export interface PackSelection {
@@ -55,6 +53,8 @@ export interface RegistrySelection {
     readonly searched: readonly string[];
 }
 export interface ResolveOptions extends DiscoveryOptions {
+    /** Explicit effective project inheritance; the saved manifest remains unchanged. */
+    readonly inheritGlobal?: boolean;
     readonly registryRoot?: string;
     readonly env?: Readonly<Record<string, string | undefined>>;
     readonly installedRoot?: string;
@@ -82,13 +82,18 @@ export interface ResolvedPack {
     readonly path: string;
     readonly skillsRoot: string;
 }
+/** A selected set: the scope root becomes a symlink to its flat skill root. */
+export interface ResolvedSet {
+    readonly name: string;
+    readonly path: string;
+}
 export interface ResolvedScope {
     readonly scope: ScopeName;
     readonly root: string;
     readonly manifest: SkillsManifest;
     readonly registry: RegistrySelection;
-    readonly mode: "composed" | "pack";
-    readonly pack?: ResolvedPack;
+    readonly mode: "composed" | "set";
+    readonly set?: ResolvedSet;
     readonly bindings: readonly ResolvedBinding[];
     readonly excluded: readonly ExcludedBinding[];
 }

package/dist/core/set-origin.d.ts

@@ -0,0 +1,36 @@
+import type { ScopeName } from "./selection.js";
+/** Sidecar kept inside a set directory; dot-prefixed so membership scans ignore it. */
+export declare const SET_ORIGIN_FILE = ".skillex-set.json";
+export interface DerivedSetDeclaration {
+    readonly owner: {
+        readonly scope: ScopeName;
+        readonly root: string;
+    };
+    readonly base: string | null;
+    readonly packs: readonly string[];
+    readonly skills: readonly string[];
+    readonly removed: readonly string[];
+}
+export interface SetOrigin {
+    readonly schema: 1;
+    readonly derived?: DerivedSetDeclaration;
+    readonly provenance?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Read derivation/provenance metadata from a set directory. Absence is normal
+ * (a plain shared set); malformed metadata is a named refusal, never a guess.
+ */
+export declare function readSetOrigin(setPath: string): Promise<SetOrigin | undefined>;
+export declare function setOriginDocument(origin: SetOrigin): string;
+/** Deterministic scope-owned name for a derived set: stable per (base, owner). */
+export declare function derivedSetName(base: string | null, ownerRoot: string): string;
+/** The suffix every derived set name for this owner root carries. */
+export declare function derivedNameSuffix(ownerRoot: string): string;
+/**
+ * Invert a derived set name for this owner root: the base set name, or
+ * undefined when the name is not shaped like this owner's derived set. The
+ * bare form (`skills-<digest>`) inverts to the literal base name "skills";
+ * null-base derivations are never produced by the selection commands, and an
+ * existing derived set always reads its authoritative base from the sidecar.
+ */
+export declare function parseDerivedName(name: string, ownerRoot: string): string | undefined;

package/dist/core/sets.d.ts

@@ -1,7 +1,15 @@
 import type { CompositionMutationData, CompositionOptions, SetListData, SetShowData } from "./composition-types.js";
 import { type ResultEnvelope } from "./result.js";
+export interface CreateSetOptions extends CompositionOptions {
+    /** Existing local skill root whose entries become member references. */
+    readonly fromRoot?: string;
+    /** Repeatable explicit sources: existing paths or Git remotes. */
+    readonly from?: readonly string[];
+    /** Import source skills that have no canonical definition instead of refusing. */
+    readonly import?: boolean;
+}
 export declare function listSets(options?: CompositionOptions): Promise<ResultEnvelope<SetListData | null>>;
 export declare function showSet(name: string, options?: CompositionOptions): Promise<ResultEnvelope<SetShowData | null>>;
-export declare function createSet(name: string, options?: CompositionOptions): Promise<ResultEnvelope<CompositionMutationData | null>>;
+export declare function createSet(name: string, options?: CreateSetOptions): Promise<ResultEnvelope<CompositionMutationData | null>>;
 export declare function addSetSkills(name: string, names: readonly string[], options?: CompositionOptions): Promise<ResultEnvelope<CompositionMutationData | null>>;
 export declare function removeSetSkills(name: string, names: readonly string[], options?: CompositionOptions): Promise<ResultEnvelope<CompositionMutationData | null>>;

package/dist/index.d.ts

@@ -6,29 +6,38 @@ export type { BmadCanonicalStatus, BmadCommandClient, BmadCommandFile, BmadComma
 export { listSkills, showSkill } from "./core/catalog.js";
 export type { ListSkillsOptions, SkillDetails, SkillListData, SkillMetadata, SkillReference, SkillShowData, } from "./core/catalog-types.js";
 export { type CatalogChange, type CatalogWriteOptions, type CatalogWriteResult, type CreateSkillOptions, createSkill, importSkill, } from "./core/catalog-write.js";
+export { ClientIsolationCommand, type ClientIsolationOptions, type ClientIsolationPlan, type ClientIsolationResult, type ClientVerification, type ClientVerifyOptions, isolateClient, type OpenCodeRequest, unisolateClient, verifyClientIsolation, } from "./core/client-isolation.js";
 export type { CompositionChange, CompositionDetails, CompositionMutationData, CompositionOptions, PackListData, PackShowData, SetListData, SetShowData, } from "./core/composition-types.js";
+export type { DerivationInputs, DerivationOwner, DerivationPreview, } from "./core/derivation.js";
+export { derivedState, desiredDerivedMembers, materializeDerivedSet, ownedDerivedName, planDerivedSet, retireDerivedSet, } from "./core/derivation.js";
 export { explainSkill, inspectStatus } from "./core/diagnostics.js";
 export type { AliasObservation, DiagnosticOptions, ExplainResult, PathObservation, ReceiptObservation, SkillExplanation, SkillObservation, StatusResult, StatusScope, } from "./core/diagnostics-types.js";
 export { discoverRegistry, discoverScopes } from "./core/discovery.js";
 export { doctor } from "./core/doctor.js";
 export type { ConfiguredLegacyWriter, DoctorOptions, DoctorResult, DoctorSourceInspection, DoctorWriterInspection, RunningLegacyWriter, } from "./core/doctor-types.js";
 export { SkillexError } from "./core/error.js";
+export type { ExecutedImport, ImportExecution, PendingImport, PlannedSources, SourceEntry, SourceInventory, SourceOptions, SourceProvenance, } from "./core/import-sources.js";
+export { executeImports, inventorySkillRoot, inventorySource, membersFromInventories, planSourceMembers, provenanceFrom, releaseInventory, } from "./core/import-sources.js";
 export { type LockOptions, withLock } from "./core/lock.js";
 export { isSkillName, isVersionComponent, parseManifest, readManifest } from "./core/manifest.js";
 export { migrate } from "./core/migration.js";
 export type { MigrationItem, MigrationMapping, MigrationOptions, MigrationResult, } from "./core/migration-types.js";
-export { addPackSkills, createPack, listPacks, removePackSkills, showPack, verifyPack, } from "./core/packs.js";
+export { type NormalizeOptions, normalizeScope } from "./core/normalization.js";
+export { addPackSkills, type CreatePackOptions, createPack, listPacks, removePackSkills, showPack, verifyPack, } from "./core/packs.js";
 export type { HermesRootSelection, ProfileCandidate, ProfileChange, ProfileListResult, ProfileLocalEntry, ProfileLocation, ProfileOptions, ProfileShowResult, ProfileSummary, ProfileSyncOptions, ProfileSyncResult, } from "./core/profile-types.js";
 export { listProfiles, showProfile, syncProfile } from "./core/profiles.js";
 export { planSync, sync } from "./core/reconciliation.js";
 export type { SyncChange, SyncOptions, SyncPlan, SyncResult, SyncScopePlan, } from "./core/reconciliation-types.js";
 export { resolveSelection } from "./core/resolution.js";
 export { type Diagnostic, ExitCode, JSON_SCHEMA_VERSION, makeResult, type ResultEnvelope, type ResultOptions, } from "./core/result.js";
+export { type RetiredMiseChange, type RetiredMiseResult, type RetireMiseOptions, RetireMiseSkillTasksCommand, retireMiseSkillTasks, retireMiseText, } from "./core/retired-mise.js";
+export { adoptRoot, type RootAdoptEntry, type RootAdoptOptions, type RootAdoptResult, } from "./core/root-cutover.js";
 export type { DiscoveryOptions, ExcludedBinding, PackSelection, RegistryOptions, RegistrySelection, Resolution, ResolvedBinding, ResolvedPack, ResolvedScope, ResolveOptions, ScopeDiscovery, ScopeLocation, ScopeName, SetSelection, SkillOrigin, SkillSelection, SkillsManifest, WriteScope, } from "./core/selection.js";
 export type { SelectionChange, SelectionKind, SelectionOptions, SelectionResult, } from "./core/selection-command-types.js";
 export { disableSelection, enableSelection, initScope, setInheritance, } from "./core/selection-commands.js";
 export { readSelectionManifest, type SelectionManifestSnapshot, SelectionManifestWriteError, writeSelectionManifest, } from "./core/selection-manifest.js";
-export { addSetSkills, createSet, listSets, removeSetSkills, showSet } from "./core/sets.js";
+export { type DerivedSetDeclaration, derivedSetName, readSetOrigin, SET_ORIGIN_FILE, type SetOrigin, } from "./core/set-origin.js";
+export { addSetSkills, type CreateSetOptions, createSet, listSets, removeSetSkills, showSet, } from "./core/sets.js";
 export { inspectVendorStatus, listVendorSources, showVendorSource } from "./core/vendor-inspect.js";
 export { syncVendorSources } from "./core/vendor-sync.js";
 export type { VendorChange, VendorCheckout, VendorOptions, VendorProvenance, VendorProvenanceInput, VendorSkillStatus, VendorSource, VendorSourceListResult, VendorSourceResolution, VendorSourceShowResult, VendorSourceSkill, VendorSourcesManifest, VendorStatusResult, VendorSyncOptions, VendorSyncResult, } from "./core/vendor-types.js";