@lmzhen/dsh-evolution-skill-discovery 0.31.1 → 0.32.1

package/lib/types/maintenance.d.ts

@@ -1,62 +0,0 @@
-import type { DomainMapSnapshot } from './domain-map.ts';
-import type { SkillKey } from './identity.ts';
-/** Maintenance defaults from PLAN/MAP-009. */
-export declare const MAINTENANCE_DEFAULTS: Readonly<{
-    splitSkillThreshold: 25;
-    coarsenDomainCount: 12;
-    maxVisibleDepth: 3;
-    minChildren: 2;
-    minMembersPerChild: 3;
-    coarsenMinDomains: 3;
-    coarsenMaxDomains: 8;
-}>;
-/** Read-only per-domain audit; no coverage claim is fabricated. */
-export interface DomainAudit {
-    readonly domainId: string;
-    readonly definitionComplete: boolean;
-    readonly childCount: number;
-    readonly directSkillCount: number;
-    readonly indirectSkillCount: number;
-    readonly empty: boolean;
-    readonly orphan: boolean;
-    readonly lastUpdated: number;
-}
-/** Map-level audit. */
-export interface DomainMapAudit {
-    readonly domains: readonly DomainAudit[];
-    readonly domainCount: number;
-    readonly unclassifiedCount: number;
-}
-/** One split candidate; no domains/edges are created. */
-export interface SplitCandidate {
-    readonly domainId: string;
-    readonly directSkillCount: number;
-    readonly children: number;
-    readonly blockers: readonly string[];
-}
-/** One coarsen group; no edges are changed. */
-export interface CoarsenGroup {
-    readonly domainIds: readonly string[];
-}
-/**
- * Audit domain definitions/structure without mutating the map.
- * @param snapshot - domain facts.
- * @param visibleSkillKeys - optional view skills for unclassified count.
- * @returns per-domain audit plus map-level counts.
- */
-export declare function auditDomainMap(snapshot: DomainMapSnapshot, visibleSkillKeys?: ReadonlySet<SkillKey>): DomainMapAudit;
-/**
- * Find split candidates; no child domains are created and no skills are reassigned.
- * @param snapshot - domain facts.
- * @param threshold - minimum direct members to consider.
- * @returns candidates with blockers.
- */
-export declare function splitCandidates(snapshot: DomainMapSnapshot, threshold?: 25): readonly SplitCandidate[];
-/**
- * Find coarsen groups; only structure candidates, never edge rewrites.
- * @param snapshot - domain facts.
- * @param maxDomains - above this count coarsening is considered.
- * @returns groups of 3–8 domains, at least 2 groups.
- */
-export declare function coarsenCandidates(snapshot: DomainMapSnapshot, maxDomains?: 12): readonly CoarsenGroup[];
-//# sourceMappingURL=maintenance.d.ts.map

package/lib/types/plugin.d.ts

@@ -1,31 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import type { DomainGenerationProposal, GenerationSkillFact } from './domain-generation.ts';
-import { type DomainGenerationPort } from './domain-generation-service.ts';
-/** Plugin config; paths are supplied by the composition, never guessed. */
-export interface Config {
-    readonly domainMapPath?: string | undefined;
-    readonly sessionPath?: string | undefined;
-    readonly featureEpoch: string;
-    readonly mode?: 'off' | 'shadow' | 'on' | 'auto';
-    readonly pinDomains?: readonly string[];
-    readonly disableDomains?: readonly string[];
-    readonly tokenBudget?: number;
-    readonly staleAfterHours?: number;
-    readonly mapStale?: boolean;
-    readonly searchAvailable?: boolean;
-    readonly domainMinDomains?: number;
-    readonly domainMaxDomains?: number;
-    readonly provisionalThreshold?: number;
-    readonly maxCards?: number;
-    readonly createClassificationEnabled?: boolean;
-    readonly bootstrapDomains?: DomainGenerationProposal;
-    readonly bootstrapSkillKeys?: Readonly<Record<string, string>>;
-    readonly domainGeneration?: DomainGenerationPort;
-    readonly domainGenerationSkills?: readonly GenerationSkillFact[];
-    readonly domainGenerationSkillKeys?: Readonly<Record<string, string>>;
-}
-export declare const name = "evolution-skill-discovery";
-export declare const inject: string[];
-/** Compose discovery services from platform ports; no catalog/provider replacement. */
-export declare function apply(ctx: Context, config: Config): void;
-//# sourceMappingURL=plugin.d.ts.map

package/lib/types/runtime.d.ts

@@ -1,42 +0,0 @@
-import type { Agent } from '@deepseek-ai/dsh-agent';
-import type { DomainMapStore } from './domain-map.ts';
-import type { EffectiveDomainPolicy } from './domain-policy.ts';
-import { type SkillIndexSource } from './index.ts';
-import type { CatalogEntry, ProjectionResult } from './projection.ts';
-import type { DiscoverySessionStore } from './session-store.ts';
-/** Injectable composition ports; the platform adapter supplies concrete I/O. */
-export interface DiscoveryRuntimePorts {
-    readonly skillIndexSource: SkillIndexSource;
-    readonly map: DomainMapStore;
-    readonly policy: EffectiveDomainPolicy;
-    readonly sessionStore: DiscoverySessionStore;
-    readonly featureEpoch: string;
-    readonly mapVersion: string;
-    readonly policyDigest: string;
-    readonly adapterVersion: string;
-    readonly projectionSchemaVersion: string;
-    readonly discoveryMode: string;
-    readonly maxCards?: number | undefined;
-    readonly tokenBudget?: number | undefined;
-    readonly autoMode?: boolean | undefined;
-    readonly promoted?: boolean | (() => boolean) | undefined;
-    readonly onProjection?: ((result: ProjectionResult) => void) | undefined;
-    readonly staleAfterHours?: number | undefined;
-    readonly maxVisibleDepth?: number | undefined;
-    readonly mode?: 'off' | 'shadow' | 'on' | undefined;
-    readonly mapStale?: boolean | undefined;
-    readonly searchAvailable?: boolean | undefined;
-}
-/** G2 adapter provider wired from ports; no global platform dependency. */
-export declare class DiscoveryRuntime {
-    private readonly ports;
-    constructor(ports: DiscoveryRuntimePorts);
-    /** @returns true only when persisted session metadata allows projection. */
-    shouldProject(agent: Agent): Promise<boolean>;
-    /** @returns a complete projection for this agent's catalog entries. */
-    project(input: {
-        readonly agent: Agent;
-        readonly catalogEntries: readonly CatalogEntry[];
-    }): Promise<ProjectionResult>;
-}
-//# sourceMappingURL=runtime.d.ts.map

package/lib/types/search-entry.d.ts

@@ -1,19 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-/** Search-only composition config. Domain/projection config is intentionally absent. */
-export interface Config {
-    /** Stable feature epoch used by later projection phases; required for config compatibility. */
-    readonly featureEpoch: string;
-    /** Register the model-visible skill_search tool. Defaults to true. */
-    readonly searchEnabled?: boolean | undefined;
-    /** Legacy discovery mode; search-only accepts only off and warns otherwise. */
-    readonly mode?: 'off' | 'shadow' | 'on' | 'auto' | undefined;
-}
-export declare const name = "evolution-skill-discovery";
-export declare const inject: string[];
-/**
- * Compose the search-only discovery surface.
- * @param ctx - plugin context with skills, workingDirectory, and tools.
- * @param config - search-only configuration.
- */
-export declare function apply(ctx: Context, config: Config): void;
-//# sourceMappingURL=search-entry.d.ts.map

package/lib/types/search-judge.d.ts

@@ -1,26 +0,0 @@
-/** One independent judge's EVAL-010 labels. */
-export interface JudgeObservation {
-    readonly queryId: string;
-    readonly relevant: boolean;
-    readonly note?: string | undefined;
-}
-export interface JudgeRecord {
-    readonly schemaVersion: 1;
-    readonly querySet: 'eval-010';
-    readonly judgeKind: 'model' | 'human';
-    readonly judgeId: string;
-    readonly observations: readonly JudgeObservation[];
-}
-/** Validate a judge packet without accepting partial query coverage. */
-export declare function validateJudgeRecord(record: JudgeRecord, expectedQueryIds: readonly string[]): readonly string[];
-/** Aggregate two independent judges; no label is rewritten. */
-export interface JudgeAggregate {
-    readonly queryCount: number;
-    readonly relevantRate: number | null;
-    readonly agreementRate: number | null;
-    readonly hasModel: boolean;
-    readonly hasHuman: boolean;
-}
-/** @returns aggregate over model/human records; agreement only for shared queries. */
-export declare function aggregateJudge(records: readonly JudgeRecord[], expectedQueryIds: readonly string[]): JudgeAggregate;
-//# sourceMappingURL=search-judge.d.ts.map

package/lib/types/session-projection.d.ts

@@ -1,19 +0,0 @@
-/** Persisted discovery metadata used to keep old sessions full-catalog. */
-export interface DiscoverySessionMeta {
-    readonly discoveryMode?: 'off' | 'shadow' | 'on' | undefined;
-    readonly featureEpoch?: string | undefined;
-}
-/** @returns true only for a new, fully-enabled session in the current epoch. */
-export declare function shouldHideCatalog(meta: DiscoverySessionMeta | undefined, currentFeatureEpoch: string): boolean;
-/** @returns true when awareness may be emitted (shadow or on). */
-export declare function shouldEmitAwareness(meta: DiscoverySessionMeta | undefined, currentFeatureEpoch: string): boolean;
-/** @returns false when the same digest was already emitted in this session. */
-export declare function shouldEmitDigest(previousDigest: string | undefined, nextDigest: string): boolean;
-/** @returns off at <=2200 tokens, on at >=3000, shadow between. */
-export declare function projectionBudgetMode(catalogTokens: number, promoted?: boolean): 'off' | 'shadow' | 'on';
-/** @returns true when a resumed session already enabled discovery. */
-export declare function shouldInstallAwarenessOnResume(record: {
-    readonly discoveryMode: 'off' | 'shadow' | 'on';
-    readonly featureEpoch: string;
-} | undefined, featureEpoch: string): boolean;
-//# sourceMappingURL=session-projection.d.ts.map

package/lib/types/session-store.d.ts

@@ -1,22 +0,0 @@
-import type { EvolutionIoLike } from '@lmzhen/dsh-evolution-core';
-/** One persisted session's discovery mode. */
-export interface DiscoverySessionRecord {
-    readonly sessionId: string;
-    readonly discoveryMode: 'off' | 'shadow' | 'on';
-    readonly featureEpoch: string;
-    readonly projectionDigest?: string | undefined;
-}
-/** Plugin-side session metadata; platform SessionHeader has no discovery fields. */
-export declare class DiscoverySessionStore {
-    private readonly io;
-    private readonly path;
-    constructor(io: EvolutionIoLike, path: string);
-    private read;
-    /** @returns persisted metadata for one session. */
-    get(sessionId: string): Promise<DiscoverySessionRecord | undefined>;
-    /** Persist one session's mode/epoch; later writes win. */
-    put(record: DiscoverySessionRecord): Promise<void>;
-}
-/** @returns true only for a persisted enabled session in the current feature epoch. */
-export declare function shouldProjectPersistedSession(store: DiscoverySessionStore, sessionId: string, currentFeatureEpoch: string): Promise<boolean>;
-//# sourceMappingURL=session-store.d.ts.map

package/lib/types/stages.d.ts

@@ -1,6 +0,0 @@
-/** Ordered implementation stages from PLAN-DISC-001. */
-export declare const DISCOVERY_STAGES: readonly ["G0-projection", "G1-domain", "G2-projection", "G3-search", "G4-assignment", "G5-maintenance", "G6-ui", "G7-migration", "G8-release"];
-export type DiscoveryStage = (typeof DISCOVERY_STAGES)[number];
-export declare function stageIndex(stage: DiscoveryStage): number;
-export declare function mayAdvance(current: DiscoveryStage, next: DiscoveryStage): boolean;
-//# sourceMappingURL=stages.d.ts.map

package/lib/types/ui.d.ts

@@ -1,69 +0,0 @@
-/** Read-only card projection for UI; counts are intentionally separate. */
-export interface DiscoveryCardView {
-    readonly id: string;
-    readonly title: string;
-    readonly purpose: string;
-    readonly descriptionStatus: 'fresh' | 'stale' | 'failed';
-    readonly triggers: readonly string[];
-    readonly managedModelInvocableCount: number;
-    readonly externalCatalogCount: number;
-    readonly pendingCount: number;
-    readonly mapStale: boolean;
-    readonly asOf: string;
-}
-/** Read-only product state; no L1/L2 tree or task view. */
-export interface DiscoveryUiState {
-    readonly cards: readonly DiscoveryCardView[];
-    readonly unclassifiedCount: number;
-    readonly mapStale: boolean;
-    readonly completeness: 'complete' | 'partial' | 'unavailable';
-    readonly asOf: string;
-    readonly searchEnabled: boolean;
-}
-/** Allowed user policy fields; anything else is rejected. */
-export interface DiscoveryUserPolicy {
-    readonly mode?: 'auto' | 'off' | 'on' | undefined;
-    readonly maxCards?: number | undefined;
-    readonly tokenBudget?: number | undefined;
-    readonly staleAfterHours?: number | undefined;
-    readonly pinDomains?: readonly string[] | undefined;
-    readonly disableDomains?: readonly string[] | undefined;
-}
-/** @returns true when the policy only edits supported fields. */
-export declare function isDiscoveryUserPolicy(value: unknown): value is DiscoveryUserPolicy;
-/** Static skill_manage description; no dynamic domain list/count/tree. */
-export declare const SKILL_MANAGE_DESCRIPTION = "Manage skill content. create may include an optional domain proposal when create-side domain cards are available; no proposal means unclassified. Domain assignment never blocks skill creation and is stored as a sidecar.";
-/** Future skill_domains contract; NOT a search parameter and not implemented in v0. */
-export interface SkillDomainsContract {
-    readonly action: 'list' | 'expand';
-    readonly domainId?: string | undefined;
-    readonly depth?: 1 | 2 | undefined;
-}
-/** Replayable behavior metrics; no prompt sentence lock. */
-export interface DiscoveryBehaviorObservation {
-    readonly awarenessShown: boolean;
-    readonly awarenessRecalled: boolean;
-    readonly silentMiss: boolean;
-    readonly searched: boolean;
-    readonly overSearch: boolean;
-    readonly underSearch: boolean;
-    readonly wrongLoad: boolean;
-    readonly taskSuccess: boolean;
-    readonly tokens: number;
-    readonly fallback: boolean;
-}
-/** Behavior metrics for one fixture/replay batch. */
-export interface DiscoveryBehaviorMetrics {
-    readonly awarenessRecall: number | null;
-    readonly silentMissRate: number | null;
-    readonly overSearchRate: number | null;
-    readonly underSearchRate: number | null;
-    readonly wrongLoadRate: number | null;
-    readonly taskSuccess: number | null;
-    readonly tokens: number;
-    readonly fallbackRate: number | null;
-    readonly total: number;
-}
-/** @returns recomputable behavior metrics; null means no denominator. */
-export declare function computeBehaviorMetrics(observations: readonly DiscoveryBehaviorObservation[]): DiscoveryBehaviorMetrics;
-//# sourceMappingURL=ui.d.ts.map