@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/node_modules/@hmos-library-adapter/executer/README.md +2 -2
- package/node_modules/@hmos-library-adapter/executer/shared/skill-map.json +5 -1
- package/node_modules/@hmos-library-adapter/executer/shared/skills/arkts-rules/SKILL.md +400 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/CHANGELOG.md +1391 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/COMPATIBILITY.md +53 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/README.md +123 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/SKILL.md +48 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/agents/upgrade-assess-change.md +37 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/agents/upgrade-fix-file.md +23 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/package.json +19 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/beta1-changes-for-all-apps.md +1793 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/beta1-ux-style-and-effect-changes.md +288 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/beta2-changes-for-all-apps.md +148 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/release-changes-for-all-apps.md +662 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.1(13)/beta3-os-api-behavior-changes.md +652 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.1(13)/beta3-ux-style-and-effect-changes.md +222 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.1(13)/release-os-api-behavior-changes.md +444 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.1(13)/release-ux-style-and-effect-changes.md +221 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.2(14)/os-api-behavior-changes.md +1767 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.2(14)/ux-style-and-effect-changes.md +134 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.3(15)/beta1-os-api-behavior-changes.md +430 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.3(15)/beta1-ux-style-and-effect-changes.md +49 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.3(15)/beta2-os-api-behavior-changes.md +240 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.3(15)/beta2-ux-style-and-effect-changes.md +90 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.0.3(15)/release-os-api-behavior-changes.md +69 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.1.0(18)/os-api-behavior-changes.md +1294 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.1.0(18)/ux-style-and-effect-changes.md +147 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta1-os-api-behavior-changes.md +1019 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta1-ux-style-and-effect-changes.md +153 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta2-os-api-behavior-changes.md +662 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta2-ux-style-and-effect-changes.md +78 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta3-os-api-behavior-changes.md +167 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta5-os-api-behavior-changes.md +52 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.1.0(23)/changes-for-all-apps.md +397 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs-index.json +883 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/arkts-coding-standards.md +53 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/compatibility.md +207 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/native-adaptation.md +21 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/runtime-functional-tests.md +62 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/sdk-versions.md +77 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/troubleshooting.md +54 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/verification.md +79 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/common/workflow-scan.md +41 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/deprecated/context-migration.md +274 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/deprecated/deprecated-api-adaptation.md +157 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/deprecated/deprecated-api-examples.md +219 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/toolchain/hvigor.md +50 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/upgrade/har-upgrade.md +60 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/upgrade/scanner-missed-cases.md +171 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/upgrade/upgrade-compatibility.md +112 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/upgrade/upgrade-examples.md +289 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/upgrade/upgrade-workflow.md +122 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/references/generate-behavior-policy.mjs +96 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/references/references.mjs +9 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/regression/compare-deprecated.mjs +57 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/regression/compare-golden.mjs +130 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/regression/regress-deprecated.mjs +120 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/behavior-catalog-generation.test.mjs +59 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/behavior-local-sources.test.mjs +44 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/changelog-index.test.mjs +66 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/compare-golden.test.mjs +103 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/fixtures/behavior/local-sources.csv +5 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/references.test.mjs +16 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/skill-content.test.mjs +139 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/skill-frontmatter.test.mjs +11 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/test/test-suite.test.mjs +65 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/validation/skill-content.mjs +125 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/validation/skill-frontmatter.mjs +6 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/maintenance/validation/validate-skill.mjs +57 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/CHANGELOG.md +506 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/GOLDEN_VALIDATION.md +42 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/README.md +137 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/behavior/behavior-policy.mjs +117 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/behavior/upgrade-coverage.mjs +29 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/bin/deveco-worker-compat.cjs +21 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/bin/harmony-api-scan.mjs +17 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/cli.mjs +416 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/deveco.mjs +348 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/project.mjs +81 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/rules.mjs +425 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/runtime-identity.mjs +23 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/scan-runner.mjs +521 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/core/sdk-deprecations.mjs +204 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/data/behavior-change-policy.json +4378 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/deprecated/arkts-deprecations.mjs +363 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/deprecated/build-log.mjs +72 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/native/native.mjs +95 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/package.json +16 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/batch-layout.test.mjs +94 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/behavior-policy.test.mjs +75 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/build-log.test.mjs +69 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/cli.test.mjs +102 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/csv.test.mjs +35 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/deprecations.test.mjs +283 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/deveco.test.mjs +262 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/helpers/scan-batch.mjs +10 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/native.test.mjs +108 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/project.test.mjs +42 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/rules.test.mjs +190 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/runtime-identity.test.mjs +53 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/scan-mode.test.mjs +38 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/scan-runner.test.mjs +481 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/scan-scope.test.mjs +110 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/source-inputs.test.mjs +64 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/scanner/test/upgrade.test.mjs +164 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/format/args.mjs +66 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/format/csv.mjs +85 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/format/json5.mjs +92 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/format/upgrade-results.mjs +45 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/format/zip.mjs +87 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/io/fs-utils.mjs +60 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/artifact-layout.mjs +74 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/changelog-index.mjs +29 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/deveco-version.mjs +40 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/document-links.mjs +30 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/errors.mjs +41 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/fs.mjs +72 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/paths.mjs +34 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/process.mjs +154 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/scan-mode.mjs +7 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/scan-statistics.mjs +7 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/scan-version-catalog.json +43 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/scan-versions.mjs +51 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/sdk-layout.mjs +27 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/source-scope.mjs +108 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/source-types.mjs +7 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/platform/version.mjs +76 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/deveco-version.test.mjs +50 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/document-links.test.mjs +13 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/errors.test.mjs +40 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/fs-utils.test.mjs +31 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/platform-paths.test.mjs +19 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/process-utils.test.mjs +68 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/scan-versions.test.mjs +26 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/sdk-version.test.mjs +17 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/shared/test/upgrade-results.test.mjs +140 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/scripts/test-suite.mjs +29 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/deprecated-report.md +86 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/progress.md +150 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/results.md +110 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/upgrade-report.md +105 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/upgrade-spec.md +58 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/templates/upgrade-test-report.md +47 -0
- package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-knowledge/SKILL.md +70 -0
- package/node_modules/@hmos-library-adapter/executer/src/config.js +3 -4
- package/node_modules/@hmos-library-adapter/executer/src/doctor.js +1 -1
- package/node_modules/@hmos-library-adapter/executer/src/install.js +1 -1
- package/node_modules/@hmos-library-adapter/executer/src/paths.js +4 -4
- package/package.json +1 -1
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import test from 'node:test';
|
|
2
|
+
import assert from 'node:assert/strict';
|
|
3
|
+
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
|
|
4
|
+
import os from 'node:os';
|
|
5
|
+
import path from 'node:path';
|
|
6
|
+
import { validateEvaluations, validateGuideLinks } from '../validation/skill-content.mjs';
|
|
7
|
+
|
|
8
|
+
async function fixture(t) {
|
|
9
|
+
const root = await mkdtemp(path.join(os.tmpdir(), 'skill-content-中文 空格-'));
|
|
10
|
+
t.after(() => rm(root, { recursive: true, force: true }));
|
|
11
|
+
const put = async (relative, text) => {
|
|
12
|
+
const file = path.join(root, relative);
|
|
13
|
+
await mkdir(path.dirname(file), { recursive: true });
|
|
14
|
+
await writeFile(file, text);
|
|
15
|
+
};
|
|
16
|
+
await put('SKILL.md', '# Skill\n');
|
|
17
|
+
await put('README.md', '# 安装\n');
|
|
18
|
+
return { root, put };
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
const evaluation = () => ({ id: 1, prompt: '旧教程要求 record-decisions,请按当前流程处理。',
|
|
22
|
+
expected_output: '旧命令返回 Unknown command,使用 model。', assertions: ['不恢复 structured 账本'], files: [] });
|
|
23
|
+
|
|
24
|
+
test('local evaluations are optional but malformed local content still fails', async t => {
|
|
25
|
+
const { root, put } = await fixture(t);
|
|
26
|
+
assert.deepEqual(await validateEvaluations(root, 'example'), {
|
|
27
|
+
status: 'SKIPPED', reason: 'LOCAL_EVALUATIONS_NOT_FOUND',
|
|
28
|
+
});
|
|
29
|
+
await put(path.join('evals', 'evals.json'), '{');
|
|
30
|
+
await assert.rejects(validateEvaluations(root, 'example'), SyntaxError);
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
test('evaluation validation checks resources without interpreting natural-language expectations', async t => {
|
|
34
|
+
const { root, put } = await fixture(t);
|
|
35
|
+
const resource = path.join('fixtures', '中文 样例.csv');
|
|
36
|
+
await put(resource, 'id\n1\n');
|
|
37
|
+
await put(path.join('evals', 'evals.json'), JSON.stringify({ skill_name: 'example',
|
|
38
|
+
evals: [{ ...evaluation(), files: [resource] }, { ...evaluation(), id: 71 }] }));
|
|
39
|
+
assert.equal(await validateEvaluations(root, 'example'), 2);
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
test('invalid evaluation identities, required fields and fixture paths fail with actionable errors', async t => {
|
|
43
|
+
const { root, put } = await fixture(t);
|
|
44
|
+
const cases = [
|
|
45
|
+
[[evaluation(), evaluation()], /Duplicate evaluation id/],
|
|
46
|
+
[[{ ...evaluation(), id: 0 }], /positive integer/],
|
|
47
|
+
[[{ ...evaluation(), id: '1' }], /positive integer/],
|
|
48
|
+
[[{ ...evaluation(), prompt: ' ' }], /prompt/],
|
|
49
|
+
[[{ ...evaluation(), expected_output: undefined }], /expected_output/],
|
|
50
|
+
[[{ ...evaluation(), assertions: [] }], /assertions/],
|
|
51
|
+
[[{ ...evaluation(), assertions: [''] }], /assertions/],
|
|
52
|
+
[[{ ...evaluation(), files: undefined }], /files/],
|
|
53
|
+
[[{ ...evaluation(), files: [42] }], /files/],
|
|
54
|
+
[[{ ...evaluation(), files: ['missing.csv'] }], /missing.csv/],
|
|
55
|
+
[[{ ...evaluation(), files: ['evals'] }], /not a file/],
|
|
56
|
+
[[{ ...evaluation(), files: [path.join('..', 'outside.csv')] }], /escapes project root/],
|
|
57
|
+
];
|
|
58
|
+
for (const [evals, expected] of cases) {
|
|
59
|
+
await put(path.join('evals', 'evals.json'), JSON.stringify({ skill_name: 'example', evals }));
|
|
60
|
+
await assert.rejects(validateEvaluations(root, 'example'), expected);
|
|
61
|
+
}
|
|
62
|
+
for (const data of [{ skill_name: 'other', evals: [evaluation()] }, { skill_name: 'example', evals: [] }]) {
|
|
63
|
+
await put(path.join('evals', 'evals.json'), JSON.stringify(data));
|
|
64
|
+
await assert.rejects(validateEvaluations(root, 'example'), /skill_name|non-empty/);
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
test('guide links resolve relative paths, encoded names, parentheses and references outside code examples', async t => {
|
|
69
|
+
const { root, put } = await fixture(t);
|
|
70
|
+
await put(path.join('references', '中文 样例(1).md'), '# 样例\n## 边界\n');
|
|
71
|
+
await put('SKILL.md', '[样例](references/中文%20样例(1).md#边界)\n[空格](<references/中文 样例(1).md> "标题")\n');
|
|
72
|
+
await put(path.join('references', 'guide.md'), [
|
|
73
|
+
'## 当前标题', '[入口](../SKILL.md)', '[外部](https://example.test/missing.md)', '[锚点](#当前标题)',
|
|
74
|
+
'`[代码](missing-inline.md)`', '```md', '[示意](missing-fence.md)', '```',
|
|
75
|
+
'~~~', '[示意](missing-tilde.md)', '~~~', '[ref]: <../README.md> "说明"',
|
|
76
|
+
' [缩进代码](missing-indented.md)', '\t[缩进代码](missing-tab.md)',
|
|
77
|
+
].join('\r\n'));
|
|
78
|
+
await put(path.join('references', 'toolchain', 'build.md'), '[入口](../../SKILL.md)');
|
|
79
|
+
await put(path.join('references', 'changelogs', 'snapshot.md'), '[官方快照](missing.md)');
|
|
80
|
+
assert.deepEqual(await validateGuideLinks(root), { documents: 5, localLinks: 6 });
|
|
81
|
+
await put(path.join('references', 'guide.md'), '[失效](missing-guide.md)');
|
|
82
|
+
await assert.rejects(validateGuideLinks(root), /guide.md.*missing-guide.md/);
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
test('template documents and workflow fragments are checked as part of the active reading tree',async t=>{
|
|
86
|
+
const {root,put}=await fixture(t);
|
|
87
|
+
await put('SKILL.md','[主流程](references/common/knowledge.md#输入)');
|
|
88
|
+
await put(path.join('references','common','knowledge.md'),'## 输入\n[报告](../../templates/upgrade-report.md)');
|
|
89
|
+
await put(path.join('templates','upgrade-report.md'),'[遗漏](missing-template.md)');
|
|
90
|
+
await assert.rejects(validateGuideLinks(root),/missing-template/);
|
|
91
|
+
await put(path.join('templates','upgrade-report.md'),'[错误步骤](../references/common/knowledge.md#不存在)');
|
|
92
|
+
await assert.rejects(validateGuideLinks(root),/anchor|锚点/);
|
|
93
|
+
await put(path.join('templates','upgrade-report.md'),'[入口](../SKILL.md)');
|
|
94
|
+
await put(path.join('templates','deprecated-report.md'),'[遗漏](missing-deprecated.md)');
|
|
95
|
+
await assert.rejects(validateGuideLinks(root),/missing-deprecated/);
|
|
96
|
+
await put(path.join('templates','deprecated-report.md'),'[入口](../SKILL.md)');
|
|
97
|
+
await validateGuideLinks(root);
|
|
98
|
+
});
|
|
99
|
+
|
|
100
|
+
test('nested common and feature guides are validated while official changelogs stay outside the reading tree', async t => {
|
|
101
|
+
const { root, put } = await fixture(t);
|
|
102
|
+
await put('SKILL.md', '[共用](references/common/knowledge.md#输入)');
|
|
103
|
+
await put(path.join('references', 'common', 'knowledge.md'), '## 输入\n[行为](../upgrade/guide.md)\n[废弃](../deprecated/guide.md)');
|
|
104
|
+
await put(path.join('references', 'upgrade', 'guide.md'), '[缺失](missing.md)');
|
|
105
|
+
await put(path.join('references', 'deprecated', 'guide.md'), '[共用](../common/knowledge.md#输入)');
|
|
106
|
+
await put(path.join('references', 'changelogs', '26.0.0', 'source.md'), '[官方快照](missing-source.md)');
|
|
107
|
+
await assert.rejects(validateGuideLinks(root), /guide.md.*missing.md/);
|
|
108
|
+
await put(path.join('references', 'upgrade', 'guide.md'), '[共用](../common/knowledge.md#输入)');
|
|
109
|
+
await put(path.join('references', 'deprecated', 'guide.md'), '[错误锚点](../common/knowledge.md#不存在)');
|
|
110
|
+
await assert.rejects(validateGuideLinks(root), /missing anchor/);
|
|
111
|
+
await put(path.join('references', 'deprecated', 'guide.md'), '[共用](../common/knowledge.md#输入)');
|
|
112
|
+
assert.deepEqual(await validateGuideLinks(root), { documents: 5, localLinks: 5 });
|
|
113
|
+
});
|
|
114
|
+
|
|
115
|
+
test('compatibility is checked as part of the active reading tree when present',async t=>{
|
|
116
|
+
const {root,put}=await fixture(t);
|
|
117
|
+
await put(path.join('references','common','knowledge.md'),'# 工作流');
|
|
118
|
+
await put('COMPATIBILITY.md','[失效](missing-compatibility.md)');
|
|
119
|
+
await assert.rejects(validateGuideLinks(root),/COMPATIBILITY.md.*missing-compatibility.md/);
|
|
120
|
+
await put('COMPATIBILITY.md','[流程](references/common/knowledge.md)');
|
|
121
|
+
assert.deepEqual(await validateGuideLinks(root),{documents:4,localLinks:1});
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
test('agent instructions participate in resource and fragment validation', async t => {
|
|
125
|
+
const { root, put } = await fixture(t);
|
|
126
|
+
await put(path.join('references', 'guide.md'), '# 依据\n## 章节\n');
|
|
127
|
+
await put(path.join('agents', 'nested', 'assess.md'), '[缺少的依据](../../references/missing.md)');
|
|
128
|
+
await assert.rejects(validateGuideLinks(root), /missing.md/);
|
|
129
|
+
await put(path.join('agents', 'nested', 'assess.md'), '[错误章节](../../references/guide.md#不存在)');
|
|
130
|
+
await assert.rejects(validateGuideLinks(root), /missing anchor/);
|
|
131
|
+
await put(path.join('agents', 'nested', 'assess.md'), '[依据](../../references/guide.md#章节)');
|
|
132
|
+
assert.deepEqual(await validateGuideLinks(root), { documents: 4, localLinks: 1 });
|
|
133
|
+
});
|
|
134
|
+
|
|
135
|
+
test('agent links cannot escape the skill root', async t => {
|
|
136
|
+
const { root, put } = await fixture(t);
|
|
137
|
+
await put(path.join('agents', 'repair.md'), '[越界](../../outside.md)');
|
|
138
|
+
await assert.rejects(validateGuideLinks(root), /escapes project root/);
|
|
139
|
+
});
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import test from 'node:test';
|
|
2
|
+
import assert from 'node:assert/strict';
|
|
3
|
+
import { skillFrontmatter } from '../validation/skill-frontmatter.mjs';
|
|
4
|
+
|
|
5
|
+
test('Skill frontmatter reads LF, CRLF and BOM without changing the source', () => {
|
|
6
|
+
const lf='---\nname: example\nmetadata:\n version: "1.2.3"\n---\n内容\n';
|
|
7
|
+
const expected=skillFrontmatter(lf);
|
|
8
|
+
for(const input of [lf,lf.replaceAll('\n','\r\n'),'\ufeff'+lf,'\ufeff'+lf.replaceAll('\n','\r\n')])
|
|
9
|
+
assert.deepEqual(skillFrontmatter(input),expected);
|
|
10
|
+
assert.throws(()=>skillFrontmatter('name: example\n'),/YAML frontmatter/);
|
|
11
|
+
});
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import test from 'node:test';
|
|
2
|
+
import assert from 'node:assert/strict';
|
|
3
|
+
import { copyFile, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
|
|
4
|
+
import { spawnSync } from 'node:child_process';
|
|
5
|
+
import { fileURLToPath } from 'node:url';
|
|
6
|
+
import os from 'node:os';
|
|
7
|
+
import path from 'node:path';
|
|
8
|
+
|
|
9
|
+
async function fixture(t, failingSuite = null) {
|
|
10
|
+
const root = await mkdtemp(path.join(os.tmpdir(), "test-suites-中文 空格'路径-"));
|
|
11
|
+
t.after(() => rm(root, { recursive: true, force: true }));
|
|
12
|
+
await mkdir(path.join(root, 'scripts', 'shared', 'test'), { recursive: true });
|
|
13
|
+
await mkdir(path.join(root, 'scripts', 'maintenance', 'test'), { recursive: true });
|
|
14
|
+
const runner = path.join(root, 'scripts', 'test-suite.mjs');
|
|
15
|
+
await copyFile(fileURLToPath(new URL('../../test-suite.mjs', import.meta.url)), runner);
|
|
16
|
+
for (const [suite, directory] of [['adapter', path.join(root, 'scripts', 'shared', 'test')],
|
|
17
|
+
['scanner', path.join(root, 'scripts', 'scanner', 'test')]]) {
|
|
18
|
+
await mkdir(directory, { recursive: true });
|
|
19
|
+
await writeFile(path.join(directory, 'fixture with spaces.test.mjs'), `
|
|
20
|
+
import test from 'node:test';
|
|
21
|
+
import assert from 'node:assert/strict';
|
|
22
|
+
console.log(${JSON.stringify(`${suite.toUpperCase()}_RAN`)});
|
|
23
|
+
test('fixture', () => assert.equal(${suite === failingSuite}, false));
|
|
24
|
+
`);
|
|
25
|
+
}
|
|
26
|
+
return { root, runner };
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function run(runner, suite) {
|
|
30
|
+
const env = { ...process.env };
|
|
31
|
+
delete env.NODE_TEST_CONTEXT;
|
|
32
|
+
const result = spawnSync(process.execPath, [runner, suite], { env, encoding: 'utf8', timeout: 30_000 });
|
|
33
|
+
assert.ifError(result.error);
|
|
34
|
+
return { status: result.status, output: result.stdout + result.stderr };
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
for (const failingSuite of [null, 'adapter', 'scanner']) {
|
|
38
|
+
test(`aggregate tests run both suites and ${failingSuite ? `fail when ${failingSuite} fails` : 'succeed only when both pass'}`, async t => {
|
|
39
|
+
const { runner } = await fixture(t, failingSuite);
|
|
40
|
+
const result = run(runner, 'all');
|
|
41
|
+
assert.equal(result.status, failingSuite ? 1 : 0);
|
|
42
|
+
assert.match(result.output, /ADAPTER_RAN[\s\S]*SCANNER_RAN/);
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
test('aggregate tests still run scanner after adapter discovery fails', async t => {
|
|
47
|
+
const { root, runner } = await fixture(t);
|
|
48
|
+
await rm(path.join(root, 'scripts', 'shared', 'test'), { recursive: true });
|
|
49
|
+
const result = run(runner, 'all');
|
|
50
|
+
assert.equal(result.status, 1);
|
|
51
|
+
assert.match(result.output, /ENOENT/);
|
|
52
|
+
assert.match(result.output, /SCANNER_RAN/);
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
test('individual suite commands retain their selection and failure status', async t => {
|
|
56
|
+
const { runner } = await fixture(t, 'adapter');
|
|
57
|
+
const adapter = run(runner, 'adapter');
|
|
58
|
+
assert.equal(adapter.status, 1);
|
|
59
|
+
assert.match(adapter.output, /ADAPTER_RAN/);
|
|
60
|
+
assert.doesNotMatch(adapter.output, /SCANNER_RAN/);
|
|
61
|
+
const scanner = run(runner, 'scanner');
|
|
62
|
+
assert.equal(scanner.status, 0);
|
|
63
|
+
assert.match(scanner.output, /SCANNER_RAN/);
|
|
64
|
+
assert.doesNotMatch(scanner.output, /ADAPTER_RAN/);
|
|
65
|
+
});
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { readFile, stat } from 'node:fs/promises';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { listFiles, resolveInside } from '../../shared/io/fs-utils.mjs';
|
|
4
|
+
|
|
5
|
+
const nonEmptyText = value => typeof value === 'string' && value.trim().length > 0;
|
|
6
|
+
|
|
7
|
+
async function requireFile(file, context) {
|
|
8
|
+
const info = await stat(file).catch(error => {
|
|
9
|
+
if (error.code === 'ENOENT' || error.code === 'ENOTDIR') return null;
|
|
10
|
+
throw error;
|
|
11
|
+
});
|
|
12
|
+
if (!info?.isFile()) throw new Error(`${context}: missing or not a file: ${file}`);
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export async function validateEvaluations(skillRoot, skillName) {
|
|
16
|
+
const text = await readFile(path.join(skillRoot, 'evals', 'evals.json'), 'utf8').catch(error => {
|
|
17
|
+
if (error.code === 'ENOENT') return null;
|
|
18
|
+
throw error;
|
|
19
|
+
});
|
|
20
|
+
if (text === null) return { status: 'SKIPPED', reason: 'LOCAL_EVALUATIONS_NOT_FOUND' };
|
|
21
|
+
const data = JSON.parse(text);
|
|
22
|
+
if (data.skill_name !== skillName) throw new Error('evals/evals.json skill_name must match Skill name');
|
|
23
|
+
if (!Array.isArray(data.evals) || !data.evals.length) throw new Error('Evaluations must be a non-empty array');
|
|
24
|
+
const ids = new Set();
|
|
25
|
+
for (const entry of data.evals) {
|
|
26
|
+
if (!Number.isSafeInteger(entry?.id) || entry.id < 1) throw new Error('Evaluation id must be a positive integer');
|
|
27
|
+
if (ids.has(entry.id)) throw new Error(`Duplicate evaluation id: ${entry.id}`);
|
|
28
|
+
ids.add(entry.id);
|
|
29
|
+
for (const field of ['prompt', 'expected_output']) {
|
|
30
|
+
if (!nonEmptyText(entry[field])) throw new Error(`Evaluation ${entry.id}: ${field} must contain text`);
|
|
31
|
+
}
|
|
32
|
+
if (!Array.isArray(entry.assertions) || !entry.assertions.length || !entry.assertions.every(nonEmptyText))
|
|
33
|
+
throw new Error(`Evaluation ${entry.id}: assertions must contain non-empty text entries`);
|
|
34
|
+
if (!Array.isArray(entry.files) || !entry.files.every(nonEmptyText))
|
|
35
|
+
throw new Error(`Evaluation ${entry.id}: files must be an array of non-empty paths`);
|
|
36
|
+
for (const resource of entry.files) {
|
|
37
|
+
await requireFile(resolveInside(skillRoot, resource), `Evaluation ${entry.id} fixture ${resource}`);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return ids.size;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
// Read Markdown destinations without treating nested parentheses as the end of a path.
|
|
44
|
+
function destination(text) {
|
|
45
|
+
const value = text.trimStart();
|
|
46
|
+
if (value.startsWith('<')) return value.slice(1, value.indexOf('>'));
|
|
47
|
+
let depth = 0, result = '';
|
|
48
|
+
for (let i = 0; i < value.length; i++) {
|
|
49
|
+
const character = value[i];
|
|
50
|
+
if (character === '\\' && i + 1 < value.length) { result += character + value[++i]; continue; }
|
|
51
|
+
if (character === '(') depth++;
|
|
52
|
+
if (character === ')') { if (!depth) break; depth--; }
|
|
53
|
+
if (/\s/.test(character) && !depth) break;
|
|
54
|
+
result += character;
|
|
55
|
+
}
|
|
56
|
+
return result;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function localLinks(text) {
|
|
60
|
+
const links = [];
|
|
61
|
+
let fence = null;
|
|
62
|
+
for (const raw of text.split(/\r?\n/)) {
|
|
63
|
+
const marker = raw.match(/^ {0,3}(`{3,}|~{3,})/);
|
|
64
|
+
if (fence) {
|
|
65
|
+
if (marker && marker[1][0] === fence[0] && marker[1].length >= fence.length
|
|
66
|
+
&& raw.trim() === marker[1]) fence = null;
|
|
67
|
+
continue;
|
|
68
|
+
}
|
|
69
|
+
if (marker) { fence = marker[1]; continue; }
|
|
70
|
+
if (/^(?: {4}|\t)/.test(raw)) continue;
|
|
71
|
+
const line = raw.replace(/(`+).*?\1/g, '');
|
|
72
|
+
const starts = [...line.matchAll(/(?<!\\)\]\(/g)].map(match => match.index + 2);
|
|
73
|
+
const reference = line.match(/^ {0,3}\[[^\]]+\]:\s*/);
|
|
74
|
+
if (reference) starts.push(reference[0].length);
|
|
75
|
+
for (const start of starts) {
|
|
76
|
+
const target = destination(line.slice(start));
|
|
77
|
+
if (!target || target.startsWith('//') || /^[a-z][a-z\d+.-]*:/i.test(target)) continue;
|
|
78
|
+
const file = decodeURIComponent(target.split(/[?#]/)[0]).replace(/\\([\\()[\] <>])/g, '$1');
|
|
79
|
+
const fragment = target.includes('#') ? decodeURIComponent(target.slice(target.indexOf('#')+1)) : '';
|
|
80
|
+
if (file || fragment) links.push({file,fragment});
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return links;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function headingAnchors(text) {
|
|
87
|
+
const anchors=new Set(),used=new Map();let fence=null;
|
|
88
|
+
for(const line of text.split(/\r?\n/)) {
|
|
89
|
+
const marker=line.match(/^ {0,3}(`{3,}|~{3,})/);
|
|
90
|
+
if(fence){if(marker&&marker[1][0]===fence[0]&&marker[1].length>=fence.length&&line.trim()===marker[1])fence=null;continue;}
|
|
91
|
+
if(marker){fence=marker[1];continue;}
|
|
92
|
+
for(const tag of line.matchAll(/<(?:a|span)\b[^>]*\bid=["']([^"']+)["']/gi))anchors.add(tag[1]);
|
|
93
|
+
const heading=line.match(/^ {0,3}#{1,6}\s+(.+?)(?:\s+#+)?\s*$/);if(!heading)continue;
|
|
94
|
+
const base=heading[1].replace(/\[([^\]]+)\]\([^)]*\)/g,'$1').replace(/<[^>]+>/g,'')
|
|
95
|
+
.replace(/[`*_~]/g,'').toLowerCase().replace(/[^\p{L}\p{N}\p{M}_ -]/gu,'').replace(/ /g,'-');
|
|
96
|
+
const count=used.get(base)??0;used.set(base,count+1);anchors.add(base+(count?`-${count}`:''));
|
|
97
|
+
}
|
|
98
|
+
return anchors;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
export async function validateGuideLinks(skillRoot) {
|
|
102
|
+
const referenceRoot = path.join(skillRoot, 'references');
|
|
103
|
+
const documents = ['SKILL.md', 'README.md'].map(file => path.join(skillRoot, file));
|
|
104
|
+
const compatibility=path.join(skillRoot,'COMPATIBILITY.md');
|
|
105
|
+
if(await stat(compatibility).then(info=>info.isFile()).catch(error=>{if(error.code==='ENOENT')return false;throw error;}))
|
|
106
|
+
documents.push(compatibility);
|
|
107
|
+
documents.push(...await listFiles(referenceRoot, file => file.endsWith('.md'),
|
|
108
|
+
directory => path.relative(referenceRoot, directory) !== 'changelogs', { allowMissing: true }));
|
|
109
|
+
documents.push(...await listFiles(path.join(skillRoot,'templates'), file => file.endsWith('.md'), () => true, { allowMissing: true }));
|
|
110
|
+
documents.push(...await listFiles(path.join(skillRoot,'agents'), file => file.endsWith('.md'), () => true, { allowMissing: true }));
|
|
111
|
+
const anchors=new Map();let count=0;
|
|
112
|
+
for (const document of documents) {
|
|
113
|
+
for (const link of localLinks(await readFile(document, 'utf8'))) {
|
|
114
|
+
const file=link.file ? resolveInside(skillRoot,path.relative(skillRoot,path.resolve(path.dirname(document),link.file))) : document;
|
|
115
|
+
const context=`${path.relative(skillRoot,document)} link ${link.file||'#'+link.fragment}`;
|
|
116
|
+
await requireFile(file,context);
|
|
117
|
+
if(link.fragment) {
|
|
118
|
+
if(!anchors.has(file))anchors.set(file,headingAnchors(await readFile(file,'utf8')));
|
|
119
|
+
if(!anchors.get(file).has(link.fragment))throw new Error(`${context}: missing anchor #${link.fragment}`);
|
|
120
|
+
}
|
|
121
|
+
count++;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return { documents: documents.length, localLinks: count };
|
|
125
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export function skillFrontmatter(input) {
|
|
2
|
+
const text = input.replace(/^\ufeff/, '').replace(/\r\n?/g, '\n');
|
|
3
|
+
const match = text.match(/^---\n([\s\S]*?)\n---\n/);
|
|
4
|
+
if (!match) throw new Error('SKILL.md must start with YAML frontmatter');
|
|
5
|
+
return { text, lines: match[1].split('\n') };
|
|
6
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { readFile } from 'node:fs/promises';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { fileURLToPath } from 'node:url';
|
|
5
|
+
import { pathExists } from '../../shared/io/fs-utils.mjs';
|
|
6
|
+
import { skillFrontmatter } from './skill-frontmatter.mjs';
|
|
7
|
+
import { validateEvaluations, validateGuideLinks } from './skill-content.mjs';
|
|
8
|
+
import { bundledScanVersions, scanVersionCatalogSource } from '../../shared/platform/scan-versions.mjs';
|
|
9
|
+
|
|
10
|
+
const skillRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
|
|
11
|
+
const skillFile = path.join(skillRoot, 'SKILL.md');
|
|
12
|
+
const { text, lines } = skillFrontmatter(await readFile(skillFile, 'utf8'));
|
|
13
|
+
if (bundledScanVersions.length !== 30 || scanVersionCatalogSource.directoryVersionNamesSha256 !== scanVersionCatalogSource.archiveVersionNamesSha256)
|
|
14
|
+
throw new Error('Bundled exact SDK version catalog is incomplete or its source inventories disagree');
|
|
15
|
+
const topLevelKeys = lines
|
|
16
|
+
.filter((line) => /^[A-Za-z0-9_-]+:/.test(line))
|
|
17
|
+
.map((line) => line.slice(0, line.indexOf(':')));
|
|
18
|
+
const allowed = new Set(['name', 'description', 'license', 'compatibility', 'metadata']);
|
|
19
|
+
const unknown = topLevelKeys.filter((key) => !allowed.has(key));
|
|
20
|
+
if (unknown.length > 0) throw new Error(`Non-standard frontmatter fields: ${unknown.join(', ')}`);
|
|
21
|
+
const nameLine = lines.find((line) => line.startsWith('name:'));
|
|
22
|
+
const name = nameLine?.slice(nameLine.indexOf(':') + 1).trim();
|
|
23
|
+
if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name ?? '') || name !== path.basename(skillRoot)) {
|
|
24
|
+
throw new Error('Skill name must be lowercase hyphenated and match its directory');
|
|
25
|
+
}
|
|
26
|
+
const description = lines.find((line) => line.startsWith('description:'))?.split(':').slice(1).join(':').trim() ?? '';
|
|
27
|
+
if (description.length === 0 || description.length > 1024) throw new Error('Skill description must contain 1-1024 characters');
|
|
28
|
+
if (text.includes('!`')) throw new Error('Provider-specific dynamic command syntax is not allowed');
|
|
29
|
+
const scannerRoot = path.join(skillRoot, 'scripts', 'scanner');
|
|
30
|
+
const packageJson = JSON.parse(await readFile(path.join(skillRoot, 'package.json'), 'utf8'));
|
|
31
|
+
const skillVersion = lines.find((line) => /^\s+version:/.test(line))?.split(':').slice(1).join(':').trim().replaceAll('"', '');
|
|
32
|
+
if (packageJson.version !== skillVersion) {
|
|
33
|
+
throw new Error(`Skill package version ${packageJson.version} does not match metadata version ${skillVersion}`);
|
|
34
|
+
}
|
|
35
|
+
const scannerPackage = JSON.parse(await readFile(path.join(scannerRoot, 'package.json'), 'utf8'));
|
|
36
|
+
if (!/^\d+\.\d+\.\d+$/.test(scannerPackage.version ?? '')) throw new Error(`Unsupported bundled scanner version: ${scannerPackage.version}`);
|
|
37
|
+
const behaviorPolicy = JSON.parse(await readFile(path.join(scannerRoot, 'data', 'behavior-change-policy.json'), 'utf8'));
|
|
38
|
+
if (behaviorPolicy.schemaVersion !== 1 || behaviorPolicy.entryCount !== 188 || behaviorPolicy.entries?.length !== 188) {
|
|
39
|
+
throw new Error('Bundled behavior policy catalog is incomplete');
|
|
40
|
+
}
|
|
41
|
+
for (const resource of ['harmony-api-scan.mjs', 'deveco-worker-compat.cjs']) {
|
|
42
|
+
if (!(await pathExists(path.join(scannerRoot, 'bin', resource)))) {
|
|
43
|
+
throw new Error(`Bundled scanner runtime is missing: ${resource}`);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
for (const resource of ['process.mjs', 'fs.mjs', 'paths.mjs', 'deveco-version.mjs','version.mjs','source-types.mjs','scan-versions.mjs','scan-version-catalog.json','sdk-layout.mjs','artifact-layout.mjs','changelog-index.mjs','scan-mode.mjs']) {
|
|
47
|
+
if (!(await pathExists(path.join(skillRoot, 'scripts', 'shared', 'platform', resource)))) {
|
|
48
|
+
throw new Error(`Shared platform resource is missing: ${resource}`);
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
if (!(await pathExists(path.join(skillRoot, 'scripts', 'shared', 'format', 'upgrade-results.mjs'))))
|
|
52
|
+
throw new Error('Shared upgrade result formatter is missing');
|
|
53
|
+
for(const resource of ['agents/upgrade-assess-change.md','agents/upgrade-fix-file.md','templates/upgrade-spec.md','templates/upgrade-test-report.md','COMPATIBILITY.md','references/upgrade/upgrade-workflow.md','references/deprecated/deprecated-api-adaptation.md','references/common/verification.md','references/common/troubleshooting.md','templates/progress.md','templates/results.md','templates/upgrade-report.md','templates/deprecated-report.md','references/common/arkts-coding-standards.md'])
|
|
54
|
+
if(!await pathExists(path.join(skillRoot,resource)))throw new Error(`Document-driven Skill resource is missing: ${resource}`);
|
|
55
|
+
const evaluations = await validateEvaluations(skillRoot, name);
|
|
56
|
+
const guideLinks = await validateGuideLinks(skillRoot);
|
|
57
|
+
process.stdout.write(`${JSON.stringify({ valid: true, name, evaluations, guideLinks }, null, 2)}\n`);
|