@liuhange/dsh-data-inventory 1.0.0

package/README.md

@@ -0,0 +1,16 @@
+# @deepseek-ai/dsh-data-inventory
+
+Data inventory plugin for DeepSeek Harness. Directory scanning, value assessment, asset list generation.
+
+## Tool: inventory_data
+
+- **Parameters**: `directory` (required)
+- **Output**: Inventory report with Markdown asset table (filename/size/type/value/description)
+
+## Business Rules
+
+Value assessment rules (keywords, scores, labels) are read from `config/business-rules.json`.
+
+## Known Limitations and Deferred Work
+
+- Directory scanning is non-recursive; only top-level data files are inventoried

package/lib/index.js

@@ -0,0 +1,144 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import * as fs from "fs";
+import * as path from "path";
+import { AuditLogger, BusinessRulesLoader, PathValidator, ReportGenerator } from "@deepseek-ai/dsh-data-asset-shared";
+//#region lib/types/directoryScanner.js
+const SUPPORTED_EXTENSIONS = [
+	"csv",
+	"xlsx",
+	"json",
+	"txt"
+];
+var DirectoryScanner = class {
+	scan(directory) {
+		const files = [];
+		let skippedFiles = 0;
+		if (!fs.existsSync(directory)) return {
+			files,
+			skippedFiles
+		};
+		const entries = fs.readdirSync(directory);
+		for (const entry of entries) {
+			const fullPath = path.join(directory, entry);
+			try {
+				const stats = fs.statSync(fullPath);
+				if (!stats.isFile()) continue;
+				const ext = path.extname(entry).toLowerCase().slice(1);
+				if (!SUPPORTED_EXTENSIONS.includes(ext)) continue;
+				files.push({
+					fileName: entry,
+					fullPath,
+					size: stats.size,
+					format: ext
+				});
+			} catch {
+				skippedFiles++;
+			}
+		}
+		return {
+			files,
+			skippedFiles
+		};
+	}
+};
+//#endregion
+//#region lib/types/valueAssessor.js
+var ValueAssessor = class {
+	assess(fileName, rules) {
+		const ruleLevels = [
+			rules.highValue,
+			rules.mediumValue,
+			rules.lowValue
+		];
+		for (const rule of ruleLevels) for (const keyword of rule.keywords) if (fileName.includes(keyword)) return {
+			stars: rule.score,
+			label: rule.label,
+			recommendation: rule.recommendation
+		};
+		return {
+			stars: rules.defaultValue.score,
+			label: rules.defaultValue.label,
+			recommendation: rules.defaultValue.recommendation
+		};
+	}
+};
+//#endregion
+//#region lib/types/assetListGenerator.js
+var AssetListGenerator = class {
+	generate(files, valueAssessor, valueRules) {
+		return files.map((file) => {
+			const assessment = valueAssessor.assess(file.fileName, valueRules);
+			return {
+				fileName: file.fileName,
+				size: this.humanReadableSize(file.size),
+				type: file.format,
+				valueAssessment: assessment.label,
+				description: assessment.recommendation
+			};
+		});
+	}
+	humanReadableSize(bytes) {
+		if (bytes < 1024) return `${bytes} B`;
+		if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+		if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+		return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+	}
+};
+//#endregion
+//#region lib/types/index.js
+const name = "data-inventory";
+const inject = ["tools"];
+function apply(ctx) {
+	const loader = new BusinessRulesLoader();
+	const reportGenerator = new ReportGenerator();
+	const pathValidator = new PathValidator();
+	const auditLogger = new AuditLogger();
+	const directoryScanner = new DirectoryScanner();
+	const valueAssessor = new ValueAssessor();
+	const assetListGenerator = new AssetListGenerator();
+	ctx.tools.register(defineTool({
+		name: "inventory_data",
+		description: "盘点数据资产，生成资产清单和价值评估",
+		parameters: { directory: {
+			type: "string",
+			required: true,
+			description: "待盘点的目录路径"
+		} },
+		output: {
+			schema: { type: "string" },
+			render: (_args, value) => [{
+				type: "text",
+				text: value
+			}]
+		},
+		async execute(args) {
+			const { config } = loader.load();
+			const workingDir = process.cwd();
+			try {
+				pathValidator.validateDirectory(args.directory, workingDir);
+			} catch {
+				return `错误：路径不合法 - ${args.directory}`;
+			}
+			const dir = path.resolve(args.directory);
+			if (!fs.existsSync(dir)) return `错误：目录不存在 - ${dir}`;
+			const scanResult = directoryScanner.scan(dir);
+			const assetItems = assetListGenerator.generate(scanResult.files, valueAssessor, config.valueAssessment);
+			const report = reportGenerator.generateInventoryReport({
+				directory: dir,
+				fileCount: scanResult.files.length,
+				assetItems
+			});
+			auditLogger.log({
+				pluginName: "data-inventory",
+				operation: "inventory_data",
+				inputPath: dir,
+				outputPath: "-",
+				result: "SUCCESS"
+			});
+			return report;
+		}
+	}));
+	console.log("[data-inventory] 盘点插件已加载");
+}
+//#endregion
+export { apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,5 @@
+//#region lib/types/invariant.js
+const invariant = "data-inventory";
+function install() {}
+//#endregion
+export { install, invariant };

package/lib/types/assetListGenerator.d.ts

@@ -0,0 +1,7 @@
+import type { AssetItem, DataFile } from '@deepseek-ai/dsh-data-asset-shared';
+import type { ValueAssessor } from './valueAssessor.js';
+export declare class AssetListGenerator {
+    generate(files: DataFile[], valueAssessor: ValueAssessor, valueRules: import('@deepseek-ai/dsh-data-asset-shared').ValueAssessmentRules): AssetItem[];
+    humanReadableSize(bytes: number): string;
+}
+//# sourceMappingURL=assetListGenerator.d.ts.map

package/lib/types/directoryScanner.d.ts

@@ -0,0 +1,9 @@
+import type { DataFile } from '@deepseek-ai/dsh-data-asset-shared';
+export interface DirectoryScanResult {
+    files: DataFile[];
+    skippedFiles: number;
+}
+export declare class DirectoryScanner {
+    scan(directory: string): DirectoryScanResult;
+}
+//# sourceMappingURL=directoryScanner.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "data-inventory";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,3 @@
+export declare const invariant = "data-inventory";
+export declare function install(): void;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/valueAssessor.d.ts

@@ -0,0 +1,10 @@
+import type { ValueAssessmentRules } from '@deepseek-ai/dsh-data-asset-shared';
+export interface ValueAssessResult {
+    stars: number;
+    label: string;
+    recommendation: string;
+}
+export declare class ValueAssessor {
+    assess(fileName: string, rules: ValueAssessmentRules): ValueAssessResult;
+}
+//# sourceMappingURL=valueAssessor.d.ts.map

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@liuhange/dsh-data-inventory",
+  "description": "Data inventory plugin: directory scanning, value assessment, asset list generation",
+  "version": "1.0.0",
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "git+https://github.com/deepseek-ai/deepseek-harness.git", "directory": "packages/data-asset/data-inventory" },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": { "types": "./lib/types/index.d.ts", "default": "./lib/index.js" },
+    "./invariant": { "types": "./lib/types/invariant.d.ts", "default": "./lib/invariant.js" },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": ["lib/index.js", "lib/invariant.js", "lib/types/**/*.d.ts"],
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^0.1.0",
+    "@deepseek-ai/dsh-tools": "^0.1.0",
+    "@liuhange/dsh-data-asset-shared": "^1.0.0"
+  }
+}