@mison/ling 1.0.0

package/tests/doctor.test.js

@@ -0,0 +1,94 @@
+const { test, describe, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const CodexAdapter = require('../bin/adapters/codex');
+const GeminiAdapter = require('../bin/adapters/gemini');
+
+describe('Doctor Command', () => {
+    let workDir;
+
+    beforeEach(() => {
+        workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'doctor-test-'));
+        // Setup mock environment
+        // Gemini
+        fs.mkdirSync(path.join(workDir, '.agent', 'agents'), { recursive: true });
+        fs.mkdirSync(path.join(workDir, '.agent', 'skills'), { recursive: true });
+        fs.mkdirSync(path.join(workDir, '.agent', 'rules'), { recursive: true });
+        fs.mkdirSync(path.join(workDir, '.agent', 'workflows'), { recursive: true });
+        fs.writeFileSync(path.join(workDir, '.agent', 'agents', 'orchestrator.md'), '# orchestrator');
+        fs.writeFileSync(path.join(workDir, '.agent', 'skills', 'doc.md'), '# skills');
+        fs.writeFileSync(path.join(workDir, '.agent', 'rules', 'GEMINI.md'), '# rules');
+        fs.writeFileSync(path.join(workDir, '.agent', 'workflows', 'create.md'), '# workflow');
+        // Codex
+        fs.mkdirSync(path.join(workDir, '.agents'));
+        fs.writeFileSync(path.join(workDir, '.agents', 'manifest.json'), JSON.stringify({ version: 2, target: 'codex', files: {} }));
+    });
+
+    afterEach(() => {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    });
+
+    test('GeminiAdapter checkIntegrity ok', () => {
+        const adapter = new GeminiAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'ok');
+    });
+
+    test('GeminiAdapter checkIntegrity missing', () => {
+        fs.rmSync(path.join(workDir, '.agent'), { recursive: true });
+        const adapter = new GeminiAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'missing');
+    });
+
+    test('GeminiAdapter checkIntegrity should flag missing required files', () => {
+        fs.rmSync(path.join(workDir, '.agent', 'rules', 'GEMINI.md'));
+        const adapter = new GeminiAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'broken');
+        assert.ok(res.issues.some((issue) => issue.includes('.agent/rules/GEMINI.md')));
+    });
+
+    test('CodexAdapter checkIntegrity ok', () => {
+        const adapter = new CodexAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'ok');
+    });
+
+    test('CodexAdapter checkIntegrity missing', () => {
+        fs.rmSync(path.join(workDir, '.agents'), { recursive: true });
+        const adapter = new CodexAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'missing');
+    });
+
+    test('CodexAdapter checkIntegrity should flag legacy .codex directory', () => {
+        fs.mkdirSync(path.join(workDir, '.codex'), { recursive: true });
+        const adapter = new CodexAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'broken');
+        assert.ok(res.issues.some((issue) => issue.includes('.codex')));
+    });
+
+    test('CodexAdapter checkIntegrity should flag invalid manifest JSON', () => {
+        fs.writeFileSync(path.join(workDir, '.agents', 'manifest.json'), '{invalid-json');
+        const adapter = new CodexAdapter(workDir, { quiet: true });
+        const res = adapter.checkIntegrity();
+        assert.strictEqual(res.status, 'broken');
+        assert.ok(res.issues.some((issue) => issue.includes('invalid JSON')));
+    });
+
+    test('CodexAdapter fixIntegrity should migrate legacy .codex directory', () => {
+        fs.rmSync(path.join(workDir, '.agents'), { recursive: true, force: true });
+        fs.mkdirSync(path.join(workDir, '.codex'), { recursive: true });
+        fs.writeFileSync(path.join(workDir, '.codex', 'manifest.json'), JSON.stringify({ version: 2, target: 'codex', files: {} }));
+        fs.writeFileSync(path.join(workDir, '.codex', 'legacy.txt'), 'legacy');
+        const adapter = new CodexAdapter(workDir, { quiet: true });
+        const res = adapter.fixIntegrity();
+        assert.ok(res.fixed);
+        assert.ok(fs.existsSync(path.join(workDir, '.agents')));
+        assert.ok(!fs.existsSync(path.join(workDir, '.codex')));
+    });
+});

package/tests/gemini-adapter.test.js

@@ -0,0 +1,30 @@
+const { test, describe, beforeEach, afterEach } = require("node:test");
+const assert = require("node:assert");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const GeminiAdapter = require("../bin/adapters/gemini");
+
+describe("GeminiAdapter", () => {
+    let workDir;
+
+    beforeEach(() => {
+        workDir = fs.mkdtempSync(path.join(os.tmpdir(), "gemini-adapter-test-"));
+    });
+
+    afterEach(() => {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    });
+
+    test("update should work when source and target are the same directory", () => {
+        const agentDir = path.join(workDir, ".agent");
+        fs.mkdirSync(agentDir, { recursive: true });
+        fs.writeFileSync(path.join(agentDir, "SKILL.md"), "same-source-target", "utf8");
+
+        const adapter = new GeminiAdapter(workDir, { quiet: true });
+        adapter.update(agentDir);
+
+        assert.ok(fs.existsSync(path.join(agentDir, "SKILL.md")));
+        assert.strictEqual(fs.readFileSync(path.join(agentDir, "SKILL.md"), "utf8"), "same-source-target");
+    });
+});

package/tests/generator.test.js

@@ -0,0 +1,48 @@
+const { test, describe } = require('node:test');
+const assert = require('node:assert');
+const RuleGenerator = require('../bin/core/generator');
+
+describe('RuleGenerator', () => {
+    test('generate should keep codex managed guidance on .agents layout', () => {
+        const transformResult = {
+            metadata: [
+                {
+                    id: 'test-skill',
+                    originalName: 'test-skill',
+                    path: 'skills/test-skill/SKILL.md',
+                    type: 'skill',
+                },
+            ],
+        };
+
+        const { agentsMd, lingRules, codexJson } = RuleGenerator.generate(transformResult, '2.0.1');
+
+        assert.ok(agentsMd.includes('test-skill'));
+        assert.ok(agentsMd.includes('ling doctor --target codex --fix'));
+        assert.ok(agentsMd.includes('.agents/skills'));
+
+        assert.ok(lingRules.includes('Managed skills are stored under `.agents/skills`.'));
+        assert.ok(!lingRules.includes('.codex'));
+
+        assert.strictEqual(codexJson.version, '2.0.1');
+        assert.strictEqual(codexJson.skills.length, 1);
+        assert.strictEqual(codexJson.skills[0].id, 'test-skill');
+    });
+
+    test('generate should work with empty metadata', () => {
+        const transformResult = { metadata: [] };
+        const { agentsMd, lingRules, codexJson } = RuleGenerator.generate(transformResult, '2.0.1');
+
+        assert.ok(agentsMd.includes('Codex Managed'));
+        assert.ok(lingRules.includes('Ling Risk Controls'));
+        assert.deepStrictEqual(codexJson.skills, []);
+    });
+
+    test('generate should require explicit version', () => {
+        const transformResult = { metadata: [] };
+        assert.throws(
+            () => RuleGenerator.generate(transformResult),
+            /需要显式传入版本号/,
+        );
+    });
+});

package/tests/git-helper.test.js

@@ -0,0 +1,53 @@
+const { test, describe, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const GitHelper = require('../bin/utils/git-helper');
+
+describe('GitHelper', () => {
+    let workDir;
+    let gitIgnorePath;
+
+    beforeEach(() => {
+        workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'git-helper-test-'));
+        gitIgnorePath = path.join(workDir, '.gitignore');
+    });
+
+    afterEach(() => {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    });
+
+    test('removeIgnoreRules should remove target patterns', () => {
+        const content = `
+# Comment
+node_modules
+.agent
+src/
+.codex/
+        `.trim();
+        fs.writeFileSync(gitIgnorePath, content);
+
+        const result = GitHelper.removeIgnoreRules(workDir, ['.agent', '.codex'], { dryRun: false });
+        
+        assert.strictEqual(result.removedCount, 2);
+        
+        const newContent = fs.readFileSync(gitIgnorePath, 'utf8');
+        assert.ok(!newContent.includes('.agent'));
+        assert.ok(!newContent.includes('.codex'));
+        assert.ok(newContent.includes('node_modules'));
+    });
+
+    test('removeIgnoreRules should respect dryRun', () => {
+        const content = `.agent\n.codex`;
+        fs.writeFileSync(gitIgnorePath, content);
+
+        const result = GitHelper.removeIgnoreRules(workDir, ['.agent'], { dryRun: true });
+        
+        assert.strictEqual(result.removedCount, 1);
+        assert.strictEqual(result.dryRun, true);
+        
+        const newContent = fs.readFileSync(gitIgnorePath, 'utf8');
+        assert.strictEqual(newContent, content); // Should not change
+    });
+});

package/tests/global-sync.test.js

@@ -0,0 +1,133 @@
+const { test, describe, beforeEach, afterEach } = require("node:test");
+const assert = require("node:assert");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { spawnSync } = require("node:child_process");
+
+const REPO_ROOT = path.resolve(__dirname, "..");
+const CLI_PATH = path.join(REPO_ROOT, "bin", "ling.js");
+
+function runCli(args, options = {}) {
+    const env = {
+        ...process.env,
+        LING_SKIP_UPSTREAM_CHECK: "1",
+        ...options.env,
+    };
+
+    return spawnSync(process.execPath, [CLI_PATH, ...args], {
+        cwd: options.cwd || REPO_ROOT,
+        env,
+        encoding: "utf8",
+    });
+}
+
+describe("Global Sync", () => {
+    let tempDir;
+
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "ling-global-sync-test-"));
+    });
+
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+
+    test("global status should report missing when no global skills installed", () => {
+        const result = runCli(["global", "status", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 2);
+        assert.strictEqual((result.stdout || "").trim(), "missing");
+    });
+
+    test("global status should report broken when target root exists but skills are incomplete", () => {
+        fs.mkdirSync(path.join(tempDir, ".codex"), { recursive: true });
+
+        const result = runCli(["global", "status", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 1);
+        assert.strictEqual((result.stdout || "").trim(), "broken");
+    });
+
+    test("global sync should install codex skills into $HOME/.codex/skills", () => {
+        const result = runCli(["global", "sync", "--target", "codex", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const skillsRoot = path.join(tempDir, ".codex", "skills");
+        assert.ok(fs.existsSync(skillsRoot), "missing global codex skills root");
+        assert.ok(fs.existsSync(path.join(skillsRoot, "clean-code", "SKILL.md")), "missing expected skill: clean-code");
+        assert.ok(fs.existsSync(path.join(skillsRoot, "workflow-plan", "SKILL.md")), "missing expected workflow skill: workflow-plan");
+    });
+
+    test("global sync should default to syncing codex and gemini when no target is provided", () => {
+        const result = runCli(["global", "sync", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const codexRoot = path.join(tempDir, ".codex", "skills");
+        assert.ok(fs.existsSync(path.join(codexRoot, "clean-code", "SKILL.md")), "missing expected codex skill: clean-code");
+        assert.ok(fs.existsSync(path.join(codexRoot, "workflow-plan", "SKILL.md")), "missing expected codex workflow skill: workflow-plan");
+
+        const geminiCliRoot = path.join(tempDir, ".gemini", "skills");
+        assert.ok(fs.existsSync(path.join(geminiCliRoot, "clean-code", "SKILL.md")), "missing expected gemini-cli skill: clean-code");
+
+        const antigravityRoot = path.join(tempDir, ".gemini", "antigravity", "skills");
+        assert.ok(fs.existsSync(path.join(antigravityRoot, "clean-code", "SKILL.md")), "missing expected antigravity skill: clean-code");
+    });
+
+    test("global status should report installed after global sync", () => {
+        const syncResult = runCli(["global", "sync", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(syncResult.status, 0, syncResult.stderr || syncResult.stdout);
+
+        const statusResult = runCli(["global", "status", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(statusResult.status, 0, statusResult.stderr || statusResult.stdout);
+        assert.strictEqual((statusResult.stdout || "").trim(), "installed");
+    });
+
+    test("global sync should install gemini skills into both ~/.gemini/skills and ~/.gemini/antigravity/skills", () => {
+        const result = runCli(["global", "sync", "--target", "gemini", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const geminiCliRoot = path.join(tempDir, ".gemini", "skills");
+        assert.ok(fs.existsSync(geminiCliRoot), "missing global gemini-cli skills root");
+        assert.ok(fs.existsSync(path.join(geminiCliRoot, "clean-code", "SKILL.md")), "missing expected gemini-cli skill: clean-code");
+
+        const antigravityRoot = path.join(tempDir, ".gemini", "antigravity", "skills");
+        assert.ok(fs.existsSync(antigravityRoot), "missing global antigravity skills root");
+        assert.ok(fs.existsSync(path.join(antigravityRoot, "clean-code", "SKILL.md")), "missing expected antigravity skill: clean-code");
+    });
+
+    test("global sync should create backup when overwriting an existing skill", () => {
+        const skillsRoot = path.join(tempDir, ".codex", "skills", "clean-code");
+        fs.mkdirSync(skillsRoot, { recursive: true });
+        fs.writeFileSync(path.join(skillsRoot, "SKILL.md"), "modified", "utf8");
+
+        const result = runCli(["global", "sync", "--target", "codex", "--quiet"], {
+            env: { LING_GLOBAL_ROOT: tempDir },
+        });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const backupRoot = path.join(tempDir, ".ling", "backups", "global");
+        assert.ok(fs.existsSync(backupRoot), "missing backup root");
+
+        const timestamps = fs
+            .readdirSync(backupRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+        assert.ok(timestamps.length > 0, "backup timestamp directory missing");
+
+        const backupSkillPath = path.join(backupRoot, timestamps[0], "codex", "clean-code", "SKILL.md");
+        assert.ok(fs.existsSync(backupSkillPath), "backup for clean-code skill missing");
+    });
+});

package/tests/health-check-script.test.js

@@ -0,0 +1,34 @@
+const { test, describe } = require("node:test");
+const assert = require("node:assert");
+const fs = require("fs");
+const path = require("path");
+const { spawnSync } = require("node:child_process");
+const HAS_BASH = (() => {
+    const probe = spawnSync("bash", ["--version"], { encoding: "utf8" });
+    return !probe.error && probe.status === 0;
+})();
+
+describe("Health Check Script", () => {
+    test("health-check script should exist and be executable", () => {
+        const scriptPath = path.resolve(__dirname, "..", "scripts", "health-check.sh");
+        assert.ok(fs.existsSync(scriptPath), "missing scripts/health-check.sh");
+        fs.accessSync(scriptPath, fs.constants.X_OK);
+    });
+
+    test("health-check node entry should exist", () => {
+        const scriptPath = path.resolve(__dirname, "..", "scripts", "health-check.js");
+        assert.ok(fs.existsSync(scriptPath), "missing scripts/health-check.js");
+    });
+
+    test("health-check script should pass bash syntax check when bash is available", { skip: !HAS_BASH }, () => {
+        const scriptPath = path.resolve(__dirname, "..", "scripts", "health-check.sh");
+        const result = spawnSync("bash", ["-n", scriptPath], { encoding: "utf8" });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+    });
+
+    test("package scripts should expose health-check command", () => {
+        const packageJsonPath = path.resolve(__dirname, "..", "package.json");
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+        assert.strictEqual(packageJson.scripts["health-check"], "node scripts/health-check.js");
+    });
+});

package/tests/managed-block.test.js

@@ -0,0 +1,41 @@
+const { test, describe, beforeEach, afterEach } = require("node:test");
+const assert = require("node:assert");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { upsertManagedBlock } = require("../bin/utils/managed-block");
+
+describe("ManagedBlock", () => {
+    let tempDir;
+    let targetFile;
+
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "managed-block-test-"));
+        targetFile = path.join(tempDir, "AGENTS.md");
+    });
+
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+
+    test("should append managed block without removing user content", () => {
+        fs.writeFileSync(targetFile, "# User Content\n\ncustom text\n", "utf8");
+        const result = upsertManagedBlock(targetFile, "codex-core-rules", "managed line");
+
+        assert.strictEqual(result.action, "appended");
+        const content = fs.readFileSync(targetFile, "utf8");
+        assert.ok(content.includes("User Content"));
+        assert.ok(content.includes("BEGIN AG-KIT MANAGED BLOCK: codex-core-rules"));
+        assert.ok(content.includes("managed line"));
+    });
+
+    test("should update existing managed block in place", () => {
+        upsertManagedBlock(targetFile, "codex-core-rules", "v1");
+        const result = upsertManagedBlock(targetFile, "codex-core-rules", "v2");
+
+        assert.strictEqual(result.action, "updated");
+        const content = fs.readFileSync(targetFile, "utf8");
+        assert.ok(content.includes("v2"));
+        assert.ok(!content.includes("v1"));
+    });
+});

package/tests/manifest.test.js

@@ -0,0 +1,97 @@
+const { test, describe, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const ManifestManager = require('../bin/utils/manifest');
+
+describe('ManifestManager', () => {
+    let tempDir;
+
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'manifest-test-'));
+    });
+
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+
+    test('computeHash should return correct sha256', () => {
+        const content = 'hello world';
+        // echo -n "hello world" | shasum -a 256
+        const expected = 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9';
+        assert.strictEqual(ManifestManager.computeHash(content), expected);
+    });
+
+    test('generateFromDir should exclude directories and map files', () => {
+        const file1 = path.join(tempDir, 'file1.txt');
+        const dir1 = path.join(tempDir, 'dir1');
+        const file2 = path.join(dir1, 'file2.txt');
+
+        fs.writeFileSync(file1, 'content1');
+        fs.mkdirSync(dir1);
+        fs.writeFileSync(file2, 'content2');
+
+        const manifest = ManifestManager.generateFromDir(tempDir);
+        
+        // Rel paths depend on OS separator, but manifest logic normalizes to /
+        assert.strictEqual(manifest['file1.txt'], ManifestManager.computeHash('content1'));
+        assert.strictEqual(manifest['dir1/file2.txt'], ManifestManager.computeHash('content2'));
+    });
+
+    test('checkDrift should detect modifications and missing files', () => {
+        const manifestPath = path.join(tempDir, 'manifest.json');
+        const file1 = path.join(tempDir, 'file1.txt');
+        
+        fs.writeFileSync(file1, 'original');
+        
+        const mgr = new ManifestManager(manifestPath);
+        mgr.manifest.files = ManifestManager.generateFromDir(tempDir);
+        mgr.save();
+
+        // 1. No Drift
+        let drift = mgr.checkDrift(tempDir);
+        assert.strictEqual(drift.modified.length, 0);
+        assert.strictEqual(drift.missing.length, 0);
+
+        // 2. Modified
+        fs.writeFileSync(file1, 'modified');
+        drift = mgr.checkDrift(tempDir);
+        assert.strictEqual(drift.modified.length, 1);
+        assert.strictEqual(drift.modified[0], 'file1.txt');
+
+        // 3. Missing
+        fs.rmSync(file1);
+        drift = mgr.checkDrift(tempDir);
+        assert.strictEqual(drift.missing.length, 1);
+        assert.strictEqual(drift.missing[0], 'file1.txt');
+    });
+
+    test('collectSmartOverwriteConflicts should only return true user conflicts', () => {
+        const manifestPath = path.join(tempDir, 'manifest.json');
+        const file1 = path.join(tempDir, 'file1.txt');
+
+        fs.writeFileSync(file1, 'original');
+
+        const mgr = new ManifestManager(manifestPath);
+        mgr.manifest.files = ManifestManager.generateFileEntriesFromDir(tempDir, { baseDir: tempDir });
+        mgr.save();
+
+        // user modified file
+        fs.writeFileSync(file1, 'user-modified');
+
+        const incoming = {
+            'file1.txt': {
+                hash: ManifestManager.computeHash('next-version'),
+                source: 'bundled/file1.txt',
+            },
+        };
+        const conflicts = mgr.collectSmartOverwriteConflicts(tempDir, incoming);
+        assert.deepStrictEqual(conflicts, ['file1.txt']);
+
+        // if local already equals incoming hash, no conflict backup needed
+        fs.writeFileSync(file1, 'next-version');
+        const noConflicts = mgr.collectSmartOverwriteConflicts(tempDir, incoming);
+        assert.deepStrictEqual(noConflicts, []);
+    });
+});

package/tests/package-tarball.test.js

@@ -0,0 +1,33 @@
+const { test, describe } = require("node:test");
+const assert = require("node:assert");
+const path = require("path");
+const { spawnSync } = require("node:child_process");
+
+const REPO_ROOT = path.resolve(__dirname, "..");
+const NPM_COMMAND = process.platform === "win32" ? "npm.cmd" : "npm";
+
+describe("Package Tarball", () => {
+    test("npm pack --dry-run should include maintenance scripts and tests", () => {
+        const result = spawnSync(NPM_COMMAND, ["pack", "--json", "--dry-run"], {
+            cwd: REPO_ROOT,
+            encoding: "utf8",
+            shell: process.platform === "win32",
+        });
+        assert.ifError(result.error);
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const payload = JSON.parse(result.stdout);
+        assert.ok(Array.isArray(payload) && payload.length > 0, "missing npm pack json payload");
+
+        const files = new Set(payload[0].files.map((item) => item.path));
+        assert.ok(files.has("scripts/clean.js"), "tarball missing scripts/clean.js");
+        assert.ok(files.has("scripts/ci-verify.js"), "tarball missing scripts/ci-verify.js");
+        assert.ok(files.has("scripts/health-check.js"), "tarball missing scripts/health-check.js");
+        assert.ok(files.has("scripts/health-check.sh"), "tarball missing scripts/health-check.sh");
+        assert.ok(files.has("scripts/run-tests.js"), "tarball missing scripts/run-tests.js");
+        assert.ok(files.has(".spec/skills/harness-engineering/SKILL.md"), "tarball missing .spec harness-engineering skill");
+        assert.ok(files.has(".spec/templates/issues.template.csv"), "tarball missing .spec issues template");
+        assert.ok(files.has("tests/cli-smoke.test.js"), "tarball missing tests/cli-smoke.test.js");
+        assert.ok(files.has("tests/global-sync.test.js"), "tarball missing tests/global-sync.test.js");
+    });
+});