@devflow-tools/knowledge-engine 0.16.27 → 0.16.28

package/dist/retrieval-scoring-profile.js

@@ -0,0 +1,35 @@
+export const KNOWLEDGE_RETRIEVAL_SCORING_PROFILE = {
+    version: 'knowledge-r6b.rrf-v1',
+    rrfK: 60,
+    channelWeights: {
+        exact: 0.40,
+        bm25: 0.30,
+        entity: 0.20,
+        vector: 0.10,
+    },
+    pageTailWeight: 0.15,
+    pageTailCap: 0.12,
+    graphSeedMinimum: 0.32,
+    graphCandidateMinimum: 0.10,
+};
+export function weightedReciprocalRankFusion(input) {
+    const profile = input.profile ?? KNOWLEDGE_RETRIEVAL_SCORING_PROFILE;
+    const scores = new Map();
+    const activeChannels = Object.keys(profile.channelWeights)
+        .filter(channel => (input.channelRanks[channel]?.length ?? 0) > 0);
+    const maximum = activeChannels.reduce((sum, channel) => sum + profile.channelWeights[channel] / (profile.rrfK + 1), 0);
+    for (const channel of activeChannels) {
+        const weight = profile.channelWeights[channel];
+        input.channelRanks[channel].forEach((id, index) => {
+            const current = scores.get(id) ?? { rawScore: 0, normalizedScore: 0, channelRanks: {} };
+            current.rawScore += weight / (profile.rrfK + index + 1);
+            current.channelRanks[channel] = index + 1;
+            scores.set(id, current);
+        });
+    }
+    for (const value of scores.values()) {
+        value.normalizedScore = maximum > 0 ? Math.min(1, value.rawScore / maximum) : 0;
+    }
+    return scores;
+}
+//# sourceMappingURL=retrieval-scoring-profile.js.map

package/dist/retrieval-scoring-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-scoring-profile.js","sourceRoot":"","sources":["../src/retrieval-scoring-profile.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,mCAAmC,GAAqC;IACnF,OAAO,EAAE,sBAAsB;IAC/B,IAAI,EAAE,EAAE;IACR,cAAc,EAAE;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;KACb;IACD,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,IAAI;IACtB,qBAAqB,EAAE,IAAI;CAC5B,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,KAG5C;IAKC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,mCAAmC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,GAAG,EAIlB,CAAC;IACL,MAAM,cAAc,GAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAiC;SACxF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CACrD,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,YAAY,CAAC,OAAO,CAAE,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YACxF,OAAO,CAAC,QAAQ,IAAI,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,eAAe,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/source-catalog.d.ts

@@ -0,0 +1,57 @@
+import type { KnowledgeAuthority, KnowledgeCoverageGap, KnowledgeReadiness, KnowledgeSourceCatalog, KnowledgeSourceCatalogEntry, KnowledgeSourceKind, KnowledgeSourceSchema, KnowledgeTaskKind, KnowledgeVersionPolicy, ProjectKnowledgeProfile } from '@devflow-tools/sdk';
+import type { KnowledgeStore } from './knowledge-store.js';
+export interface BuildProjectKnowledgeProfileOptions {
+    activeSkills?: string[];
+    languages?: string[];
+    supportedTaskKinds?: KnowledgeTaskKind[];
+    generatedAt?: number;
+}
+export interface CreateKnowledgeSourceSchemaInput {
+    id: string;
+    sourceId: string;
+    sourceKind: KnowledgeSourceKind;
+    authority: KnowledgeAuthority;
+    versionPolicy: KnowledgeVersionPolicy;
+    allowedEntities?: string[];
+    supportedTaskKinds?: KnowledgeTaskKind[];
+    refreshStrategy?: KnowledgeSourceSchema['refreshStrategy'];
+    refreshIntervalMs?: number;
+    schemaVersion?: number;
+}
+export declare class SourceCatalog {
+    private readonly store;
+    readonly projectRoot: string;
+    constructor(store: KnowledgeStore, projectRoot: string);
+    refreshProjectProfile(options?: BuildProjectKnowledgeProfileOptions): ProjectKnowledgeProfile;
+    registerSourceSchema(input: CreateKnowledgeSourceSchemaInput): KnowledgeSourceSchema;
+    beginRefresh(sourceId: string, inputContentHash: string): ReturnType<KnowledgeStore['beginRefreshJob']>;
+    activateSource(input: {
+        schemaId: string;
+        version?: string;
+        contentHash: string;
+        readiness: KnowledgeReadiness;
+        entities?: string[];
+        symbols?: string[];
+        taskKinds?: KnowledgeTaskKind[];
+        refreshJobId?: string;
+    }): {
+        entry: KnowledgeSourceCatalogEntry;
+        snapshotId: string;
+        changed: boolean;
+    };
+    failRefresh(refreshJobId: string, error: unknown): boolean;
+    recordCoverageGap(input: Omit<KnowledgeCoverageGap, 'id' | 'projectRoot' | 'detectedAt'> & {
+        detectedAt?: number;
+    }): KnowledgeCoverageGap;
+    requireCoverage(input: {
+        sourceId: string;
+        entity?: string;
+        symbol?: string;
+        requiredVersion?: string;
+        taskKind?: KnowledgeTaskKind;
+    }): KnowledgeCoverageGap | null;
+    getCatalog(): KnowledgeSourceCatalog;
+}
+export declare function buildProjectKnowledgeProfile(projectRoot: string, options?: BuildProjectKnowledgeProfileOptions): ProjectKnowledgeProfile;
+export declare function createKnowledgeSourceSchema(input: CreateKnowledgeSourceSchemaInput): KnowledgeSourceSchema;
+//# sourceMappingURL=source-catalog.d.ts.map

package/dist/source-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-catalog.d.ts","sourceRoot":"","sources":["../src/source-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoB3D,MAAM,WAAW,mCAAmC;IAClD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;IAChC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,sBAAsB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,eAAe,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAGV,KAAK,EAAE,cAAc,EACtC,WAAW,EAAE,MAAM;IAKrB,qBAAqB,CAAC,OAAO,GAAE,mCAAwC,GAAG,uBAAuB;IAMjG,oBAAoB,CAAC,KAAK,EAAE,gCAAgC,GAAG,qBAAqB;IAMpF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAQvG,cAAc,CAAC,KAAK,EAAE;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,kBAAkB,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG;QAAE,KAAK,EAAE,2BAA2B,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAqChF,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAO1D,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,aAAa,GAAG,YAAY,CAAC,GACpF;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,oBAAoB;IAqBlD,eAAe,CAAC,KAAK,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;KAC9B,GAAG,oBAAoB,GAAG,IAAI;IAmC/B,UAAU,IAAI,sBAAsB;CAyBrC;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,mCAAwC,GAChD,uBAAuB,CAqCzB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,qBAAqB,CAcvB"}

package/dist/source-catalog.js

@@ -0,0 +1,351 @@
+import { createHash } from 'node:crypto';
+import { closeSync, existsSync, openSync, readSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+const MAX_MANIFEST_BYTES = 512 * 1024;
+const DEFAULT_TASK_KINDS = [
+    'overview', 'create', 'modify', 'debug', 'test', 'build', 'migrate', 'explain',
+];
+const FRAMEWORK_PACKAGES = [
+    { packageName: 'react', name: 'react' },
+    { packageName: 'next', name: 'nextjs' },
+    { packageName: 'vue', name: 'vue' },
+    { packageName: '@angular/core', name: 'angular' },
+    { packageName: '@nestjs/core', name: 'nest' },
+    { packageName: '@tarojs/taro', name: 'taro' },
+    { packageName: 'electron', name: 'electron' },
+    { packageName: 'tailwindcss', name: 'tailwind' },
+    { packageName: 'vitest', name: 'vitest' },
+    { packageName: '@rsbuild/core', name: 'rsbuild' },
+];
+export class SourceCatalog {
+    store;
+    projectRoot;
+    constructor(store, projectRoot) {
+        this.store = store;
+        this.projectRoot = resolve(projectRoot);
+    }
+    refreshProjectProfile(options = {}) {
+        const profile = buildProjectKnowledgeProfile(this.projectRoot, options);
+        this.store.upsertProjectProfile(profile);
+        return profile;
+    }
+    registerSourceSchema(input) {
+        const schema = createKnowledgeSourceSchema(input);
+        this.store.upsertSourceSchema(schema);
+        return schema;
+    }
+    beginRefresh(sourceId, inputContentHash) {
+        return this.store.beginRefreshJob({
+            projectRoot: this.projectRoot,
+            sourceId,
+            inputContentHash,
+        });
+    }
+    activateSource(input) {
+        const profile = this.store.getProjectProfile(this.projectRoot)
+            ?? this.refreshProjectProfile();
+        const schema = this.store.getSourceSchema(input.schemaId);
+        if (!schema)
+            throw new Error(`Knowledge source schema ${input.schemaId} is not registered`);
+        const versionGap = validateSourceVersion(schema, input.version);
+        if (versionGap) {
+            this.recordCoverageGap({
+                sourceId: schema.sourceId,
+                kind: 'incompatible_version',
+                requiredVersion: schema.versionPolicy.expectedVersion,
+                availableVersion: input.version,
+                reason: versionGap,
+            });
+            throw new Error(versionGap);
+        }
+        const entry = {
+            sourceId: schema.sourceId,
+            schemaId: schema.id,
+            sourceKind: schema.sourceKind,
+            authority: schema.authority,
+            version: input.version,
+            contentHash: input.contentHash,
+            readiness: input.readiness,
+            entities: uniqueStrings(input.entities ?? []),
+            symbols: uniqueStrings(input.symbols ?? []),
+            taskKinds: uniqueTaskKinds(input.taskKinds ?? schema.supportedTaskKinds),
+        };
+        const activated = this.store.activateCatalogEntry({
+            projectRoot: this.projectRoot,
+            profileHash: profile.profileHash,
+            entry,
+        });
+        if (input.refreshJobId)
+            this.store.completeRefreshJob(input.refreshJobId, activated.snapshotId);
+        return { entry: { ...entry, activeRevisionId: activated.snapshotId }, ...activated };
+    }
+    failRefresh(refreshJobId, error) {
+        return this.store.failRefreshJob(refreshJobId, error instanceof Error ? error.message : String(error));
+    }
+    recordCoverageGap(input) {
+        const detectedAt = input.detectedAt ?? Date.now();
+        const identity = [
+            this.projectRoot,
+            input.sourceId,
+            input.kind,
+            input.entity ?? '',
+            input.symbol ?? '',
+            input.requiredVersion ?? '',
+            input.taskKind ?? '',
+        ].join('\0');
+        const gap = {
+            ...input,
+            id: `knowledge-gap:${createHash('sha256').update(identity).digest('hex').slice(0, 32)}`,
+            projectRoot: this.projectRoot,
+            detectedAt,
+        };
+        this.store.recordCoverageGap(gap);
+        return gap;
+    }
+    requireCoverage(input) {
+        const entry = this.store.listActiveCatalogEntries(this.projectRoot)
+            .find(candidate => candidate.sourceId === input.sourceId);
+        if (!entry) {
+            return this.recordCoverageGap({
+                ...input,
+                kind: 'missing_source',
+                reason: `Knowledge source ${input.sourceId} has no active compiled revision`,
+            });
+        }
+        if (input.requiredVersion && major(input.requiredVersion) !== major(entry.version)) {
+            return this.recordCoverageGap({
+                ...input,
+                kind: 'incompatible_version',
+                availableVersion: entry.version,
+                reason: `Knowledge source ${input.sourceId} does not satisfy major version ${input.requiredVersion}`,
+            });
+        }
+        if (input.symbol && !hasNormalized(entry.symbols, input.symbol)) {
+            return this.recordCoverageGap({
+                ...input,
+                kind: 'missing_api',
+                reason: `Knowledge source ${input.sourceId} does not cover API ${input.symbol}`,
+            });
+        }
+        if (input.entity && !hasNormalized(entry.entities, input.entity)) {
+            return this.recordCoverageGap({
+                ...input,
+                kind: 'missing_entity',
+                reason: `Knowledge source ${input.sourceId} does not cover entity ${input.entity}`,
+            });
+        }
+        return null;
+    }
+    getCatalog() {
+        const profile = this.store.getProjectProfile(this.projectRoot)
+            ?? this.refreshProjectProfile();
+        const sources = this.store.listActiveCatalogEntries(this.projectRoot);
+        const coverageGaps = this.store.listCoverageGaps(this.projectRoot);
+        const generatedAt = Math.max(profile.generatedAt, ...sources.map(source => source.readiness.lastAttempt ?? source.readiness.lastSuccessfulRefresh ?? 0), ...coverageGaps.map(gap => gap.detectedAt));
+        const catalogHash = hashStable({
+            projectRoot: this.projectRoot,
+            profileHash: profile.profileHash,
+            sources,
+            coverageGaps,
+        });
+        return {
+            projectRoot: this.projectRoot,
+            profileHash: profile.profileHash,
+            catalogHash,
+            generatedAt,
+            sources,
+            coverageGaps,
+        };
+    }
+}
+export function buildProjectKnowledgeProfile(projectRoot, options = {}) {
+    const root = resolve(projectRoot);
+    const manifest = readJson(join(root, 'package.json'));
+    const dependencies = collectDependencies(manifest);
+    const packageManager = parsePackageManager(manifest.packageManager);
+    const languages = uniqueStrings([
+        ...(options.languages ?? []),
+        ...detectLanguages(root, dependencies),
+    ]).sort();
+    const frameworks = FRAMEWORK_PACKAGES.flatMap(definition => {
+        const version = dependencies[definition.packageName];
+        return version ? [{ name: definition.name, version, packageName: definition.packageName }] : [];
+    }).sort((left, right) => left.name.localeCompare(right.name));
+    const activeSkills = uniqueStrings([
+        ...(options.activeSkills ?? []),
+        ...Object.keys(dependencies)
+            .filter(name => name.startsWith('@devflow-tools/plugin-'))
+            .map(name => name.slice('@devflow-tools/plugin-'.length)),
+    ]).sort();
+    const supportedTaskKinds = uniqueTaskKinds(options.supportedTaskKinds ?? inferTaskKinds(manifest, dependencies));
+    const generatedAt = options.generatedAt ?? Date.now();
+    const profileMaterial = {
+        projectRoot: root,
+        packageManager,
+        languages,
+        frameworks,
+        dependencies,
+        activeSkills,
+        supportedTaskKinds,
+    };
+    return {
+        ...profileMaterial,
+        profileHash: hashStable(profileMaterial),
+        generatedAt,
+    };
+}
+export function createKnowledgeSourceSchema(input) {
+    const material = {
+        id: input.id,
+        sourceId: input.sourceId,
+        sourceKind: input.sourceKind,
+        authority: input.authority,
+        versionPolicy: input.versionPolicy,
+        allowedEntities: uniqueStrings(input.allowedEntities ?? []).sort(),
+        supportedTaskKinds: uniqueTaskKinds(input.supportedTaskKinds ?? DEFAULT_TASK_KINDS),
+        refreshStrategy: input.refreshStrategy ?? 'on_demand',
+        ...(input.refreshIntervalMs !== undefined ? { refreshIntervalMs: input.refreshIntervalMs } : {}),
+        schemaVersion: input.schemaVersion ?? 1,
+    };
+    return { ...material, contentHash: hashStable(material) };
+}
+function validateSourceVersion(schema, version) {
+    const policy = schema.versionPolicy;
+    if (policy.mode === 'unversioned')
+        return null;
+    if (!version)
+        return `Knowledge source ${schema.sourceId} is missing a required version`;
+    if (!policy.expectedVersion)
+        return null;
+    if (policy.mode === 'exact' && normalizeVersion(version) !== normalizeVersion(policy.expectedVersion)) {
+        return `Knowledge source ${schema.sourceId} version ${version} is incompatible with exact version ${policy.expectedVersion}`;
+    }
+    if (policy.mode === 'exact_major' && major(version) !== major(policy.expectedVersion)) {
+        return `Knowledge source ${schema.sourceId} version ${version} is incompatible with major version ${policy.expectedVersion}`;
+    }
+    return null;
+}
+function collectDependencies(manifest) {
+    const result = {};
+    for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+        const values = manifest[field];
+        if (!values || typeof values !== 'object' || Array.isArray(values))
+            continue;
+        for (const [name, version] of Object.entries(values)) {
+            if (typeof version === 'string' && !(name in result))
+                result[name] = version;
+        }
+    }
+    return Object.fromEntries(Object.entries(result).sort(([left], [right]) => left.localeCompare(right)));
+}
+function detectLanguages(root, dependencies) {
+    const languages = [];
+    if (existsSync(join(root, 'tsconfig.json')) || 'typescript' in dependencies)
+        languages.push('typescript');
+    if (existsSync(join(root, 'package.json')))
+        languages.push('javascript');
+    if (existsSync(join(root, 'pyproject.toml')) || existsSync(join(root, 'requirements.txt')))
+        languages.push('python');
+    if (existsSync(join(root, 'go.mod')))
+        languages.push('go');
+    if (existsSync(join(root, 'Cargo.toml')))
+        languages.push('rust');
+    if (existsSync(join(root, 'pom.xml')) || existsSync(join(root, 'build.gradle')))
+        languages.push('java');
+    return languages;
+}
+function inferTaskKinds(manifest, dependencies) {
+    const tasks = new Set(['overview', 'create', 'modify', 'debug', 'explain']);
+    const scripts = manifest.scripts && typeof manifest.scripts === 'object' && !Array.isArray(manifest.scripts)
+        ? manifest.scripts
+        : {};
+    if ('test' in scripts || ['vitest', 'jest', 'mocha'].some(name => name in dependencies))
+        tasks.add('test');
+    if ('build' in scripts || ['vite', '@rsbuild/core', 'webpack', 'next'].some(name => name in dependencies))
+        tasks.add('build');
+    if (Object.keys(dependencies).length > 0)
+        tasks.add('migrate');
+    return [...tasks];
+}
+function parsePackageManager(value) {
+    if (typeof value !== 'string' || !value.trim())
+        return undefined;
+    const [name, version] = value.trim().split('@');
+    return name ? { name, ...(version ? { version } : {}) } : undefined;
+}
+function readJson(path) {
+    const text = readBoundedText(path, MAX_MANIFEST_BYTES);
+    if (!text)
+        return {};
+    try {
+        const value = JSON.parse(text);
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readBoundedText(path, maxBytes) {
+    if (!existsSync(path))
+        return null;
+    let descriptor;
+    try {
+        descriptor = openSync(path, 'r');
+        const buffer = Buffer.allocUnsafe(maxBytes);
+        const bytes = readSync(descriptor, buffer, 0, maxBytes, 0);
+        return buffer.subarray(0, bytes).toString('utf8');
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    return values.filter(value => {
+        const key = normalize(value);
+        if (!key || seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function uniqueTaskKinds(values) {
+    return [...new Set(values)].sort();
+}
+function hasNormalized(values, target) {
+    const expected = normalize(target);
+    return values.some(value => normalize(value) === expected);
+}
+function normalize(value) {
+    return value.normalize('NFKC').trim().toLocaleLowerCase('en-US').replace(/\s+/gu, ' ');
+}
+function normalizeVersion(value) {
+    return value.trim().replace(/^[~^<>=v\s]+/u, '').split(/[-+]/u)[0] ?? '';
+}
+function major(value) {
+    if (!value)
+        return null;
+    return normalizeVersion(value).match(/^\d+/u)?.[0] ?? null;
+}
+function hashStable(value) {
+    return createHash('sha256').update(stableJson(value)).digest('hex');
+}
+function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=source-catalog.js.map

package/dist/source-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-catalog.js","sourceRoot":"","sources":["../src/source-catalog.ts"],"names":[],"mappings":"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"}

package/dist/source-readiness.d.ts

@@ -2,6 +2,13 @@ export interface ProjectKnowledgeVersions {
     react?: string;
     typescript?: string;
     node?: string;
+    vue?: string;
+    angular?: string;
+    nextjs?: string;
+    nest?: string;
+    vitest?: string;
+    tailwind?: string;
+    dependencies?: Record<string, string>;
 }
 export declare function detectProjectKnowledgeVersions(projectRoot: string): ProjectKnowledgeVersions;
 export declare function isKnowledgeVersionCompatible(source: string, documentVersion: string | null | undefined, projectVersions: ProjectKnowledgeVersions): boolean;

package/dist/source-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-readiness.d.ts","sourceRoot":"","sources":["../src/source-readiness.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAkB5F;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,eAAe,EAAE,wBAAwB,GACxC,OAAO,CAMT;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,wBAAwB,GACxC,MAAM,GAAG,SAAS,CAGpB"}
+{"version":3,"file":"source-readiness.d.ts","sourceRoot":"","sources":["../src/source-readiness.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,CA6B5F;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,eAAe,EAAE,wBAAwB,GACxC,OAAO,CAST;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,wBAAwB,GACxC,MAAM,GAAG,SAAS,CAMpB"}

package/dist/source-readiness.js

@@ -11,10 +11,21 @@ export function detectProjectKnowledgeVersions(projectRoot) {
             ...asRecord(pkg.devDependencies),
             ...asRecord(pkg.peerDependencies),
         };
+        const dependencyVersions = Object.fromEntries(Object.entries(dependencies).flatMap(([name, value]) => {
+            const version = majorVersion(value);
+            return version ? [[name, version]] : [];
+        }));
         return {
             react: majorVersion(dependencies.react),
             typescript: majorVersion(dependencies.typescript),
             node: majorVersion(asRecord(pkg.engines).node),
+            vue: majorVersion(dependencies.vue),
+            angular: majorVersion(dependencies['@angular/core']),
+            nextjs: majorVersion(dependencies.next),
+            nest: majorVersion(dependencies['@nestjs/core']),
+            vitest: majorVersion(dependencies.vitest),
+            tailwind: majorVersion(dependencies.tailwindcss),
+            dependencies: dependencyVersions,
         };
     }
     catch {
@@ -23,7 +34,10 @@ export function detectProjectKnowledgeVersions(projectRoot) {
 }
 export function isKnowledgeVersionCompatible(source, documentVersion, projectVersions) {
     const family = sourceFamily(source);
-    const expected = family ? projectVersions[family] : undefined;
+    const dependencyName = source.startsWith('dependency:') ? source.slice('dependency:'.length) : undefined;
+    const expected = dependencyName
+        ? projectVersions.dependencies?.[dependencyName]
+        : family ? projectVersions[family] : undefined;
     if (!expected || !documentVersion)
         return true;
     const actual = majorVersion(documentVersion);
@@ -31,7 +45,10 @@ export function isKnowledgeVersionCompatible(source, documentVersion, projectVer
 }
 export function expectedVersionForSource(source, projectVersions) {
     const family = sourceFamily(source);
-    return family ? projectVersions[family] : undefined;
+    const dependencyName = source.startsWith('dependency:') ? source.slice('dependency:'.length) : undefined;
+    return dependencyName
+        ? projectVersions.dependencies?.[dependencyName]
+        : family ? projectVersions[family] : undefined;
 }
 function sourceFamily(source) {
     if (/react/iu.test(source))
@@ -40,6 +57,18 @@ function sourceFamily(source) {
         return 'typescript';
     if (/\bnode(?:js|\.js)?\b/iu.test(source))
         return 'node';
+    if (/vue/iu.test(source))
+        return 'vue';
+    if (/angular/iu.test(source))
+        return 'angular';
+    if (/next(?:js|\.js)?/iu.test(source))
+        return 'nextjs';
+    if (/nest/iu.test(source))
+        return 'nest';
+    if (/vitest/iu.test(source))
+        return 'vitest';
+    if (/tailwind/iu.test(source))
+        return 'tailwind';
     return undefined;
 }
 function majorVersion(value) {

package/dist/source-readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-readiness.js","sourceRoot":"","sources":["../src/source-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA4B,CAAC;QACrF,MAAM,YAAY,GAAG;YACnB,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;YAC7B,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;YAChC,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC;SAClC,CAAC;QACF,OAAO;YACL,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC;YACvC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,UAAU,CAAC;YACjD,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;SAC/C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAAc,EACd,eAA0C,EAC1C,eAAyC;IAEzC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,IAAI,CAAC,QAAQ,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,eAAyC;IAEzC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IAC5D,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}
+{"version":3,"file":"source-readiness.js","sourceRoot":"","sources":["../src/source-readiness.ts"],"names":[],"mappings":"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"}

package/dist/source-selector.d.ts

@@ -1,3 +1,4 @@
+import type { KnowledgeCoverageGap, KnowledgeNeed, KnowledgeSourceCatalog, ProjectKnowledgeProfile, RetrievalTaskAction } from '@devflow-tools/sdk';
 export interface KnowledgeProjectSignals {
     frameworks?: string[];
     languages?: string[];
@@ -8,7 +9,13 @@ export interface KnowledgeProjectSignals {
 export interface KnowledgeSourceSelection {
     sources: string[];
     rejectedSources: string[];
+    rejections: Array<{
+        source: string;
+        reason: string;
+    }>;
     signals: string[];
+    missingNeeds: KnowledgeNeed[];
+    coverageGaps: Array<Omit<KnowledgeCoverageGap, 'id' | 'projectRoot' | 'detectedAt'>>;
 }
 export declare function selectKnowledgeSources(input: {
     query: string;
@@ -16,5 +23,9 @@ export declare function selectKnowledgeSources(input: {
     explicitSources?: string[];
     projectRoot?: string;
     projectSignals?: KnowledgeProjectSignals;
+    projectProfile?: ProjectKnowledgeProfile | null;
+    catalog?: KnowledgeSourceCatalog | null;
+    action?: RetrievalTaskAction;
+    knowledgeNeeds?: KnowledgeNeed[];
 }): KnowledgeSourceSelection;
 //# sourceMappingURL=source-selector.d.ts.map

package/dist/source-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-selector.d.ts","sourceRoot":"","sources":["../src/source-selector.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AACD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA8CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC1C,GAAG,wBAAwB,CAuE3B"}
+{"version":3,"file":"source-selector.d.ts","sourceRoot":"","sources":["../src/source-selector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EAGtB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AACD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC;CACtF;AA8CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,cAAc,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC,GAAG,wBAAwB,CA4I3B"}