Merge branch 'next' into kimi-runtime-support
This commit is contained in:
Colin Johnson
@@ -148,4 +148,226 @@ describe('skill-manifest', () => {
|
||||
assert.strictEqual(claudeRoot.path, path.join(homeDir, 'claude-custom', 'skills'));
|
||||
assert.strictEqual(codexRoot.path, path.join(homeDir, 'codex-custom', 'skills'));
|
||||
});
|
||||
|
||||
// bug-929: nested layout discovery
|
||||
test('bug-929: discovers concrete skills nested under gsd-ns-* routers', () => {
|
||||
// Mirrors the on-disk shape that stageSkillsForRuntimeAsSkills emits for
|
||||
// cline/qwen/hermes/augment/trae/antigravity when nested=true:
|
||||
// <root>/gsd-ns-workflow/SKILL.md — router (top-level)
|
||||
// <root>/gsd-ns-workflow/skills/plan/SKILL.md — concrete
|
||||
// <root>/gsd-ns-workflow/skills/execute/SKILL.md — concrete
|
||||
// <root>/gsd-ns-workflow/skills/spec-phase/SKILL.md — dual-routed concrete
|
||||
// <root>/gsd-ns-manage/SKILL.md — router (top-level)
|
||||
// <root>/gsd-ns-manage/skills/progress/SKILL.md — concrete
|
||||
// <root>/gsd-ns-manage/skills/spec-phase/SKILL.md — same dual-routed concrete (dedupe by name)
|
||||
// <root>/gsd-standalone/SKILL.md — flat top-level skill (no skills/ subdir)
|
||||
const skillsDir = fs.mkdtempSync(path.join(require('os').tmpdir(), 'gsd-nested-skills-'));
|
||||
|
||||
function writeNestedSkill(dir, name, description) {
|
||||
fs.mkdirSync(dir, { recursive: true });
|
||||
fs.writeFileSync(path.join(dir, 'SKILL.md'), [
|
||||
'---',
|
||||
`name: ${name}`,
|
||||
`description: ${description}`,
|
||||
'---',
|
||||
'',
|
||||
`# ${name}`,
|
||||
].join('\n'));
|
||||
}
|
||||
|
||||
// Router 1: gsd-ns-workflow
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-workflow'), 'gsd-ns-workflow', 'Workflow router');
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-workflow', 'skills', 'plan'), 'gsd-plan', 'Plan skill');
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-workflow', 'skills', 'execute'), 'gsd-execute', 'Execute skill');
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-workflow', 'skills', 'spec-phase'), 'gsd-spec-phase', 'Spec phase skill');
|
||||
|
||||
// Router 2: gsd-ns-manage
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-manage'), 'gsd-ns-manage', 'Manage router');
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-manage', 'skills', 'progress'), 'gsd-progress', 'Progress skill');
|
||||
// Same spec-phase under a second router (dual-routed); must appear exactly once in manifest
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-ns-manage', 'skills', 'spec-phase'), 'gsd-spec-phase', 'Spec phase skill');
|
||||
|
||||
// Flat top-level skill (not a router, no skills/ subdir)
|
||||
writeNestedSkill(path.join(skillsDir, 'gsd-standalone'), 'gsd-standalone', 'Standalone flat skill');
|
||||
|
||||
const result = runGsdTools(['skill-manifest', '--skills-dir', skillsDir], tmpDir);
|
||||
assert.ok(result.success, `Command should succeed: ${result.error || result.output}`);
|
||||
|
||||
const manifest = JSON.parse(result.output);
|
||||
const skillNames = manifest.skills.map((s) => s.name).sort();
|
||||
|
||||
// 2 routers + 4 unique concretes (gsd-spec-phase deduped) + 1 flat = 7 total
|
||||
assert.deepStrictEqual(skillNames, [
|
||||
'gsd-execute',
|
||||
'gsd-ns-manage',
|
||||
'gsd-ns-workflow',
|
||||
'gsd-plan',
|
||||
'gsd-progress',
|
||||
'gsd-spec-phase',
|
||||
'gsd-standalone',
|
||||
]);
|
||||
assert.strictEqual(manifest.counts.skills, 7, 'dual-routed concrete must be deduped to one entry');
|
||||
|
||||
// Concrete skills should have a forward-slash nested file_path (posix-stable on all platforms)
|
||||
const planSkill = manifest.skills.find((s) => s.name === 'gsd-plan');
|
||||
assert.ok(planSkill, 'gsd-plan should be discovered');
|
||||
assert.ok(
|
||||
planSkill.file_path.includes('skills/plan'),
|
||||
`gsd-plan file_path should reflect nested location with forward slashes, got: ${planSkill.file_path}`
|
||||
);
|
||||
|
||||
// Router should also appear as a skill entry
|
||||
const routerSkill = manifest.skills.find((s) => s.name === 'gsd-ns-workflow');
|
||||
assert.ok(routerSkill, 'gsd-ns-workflow router should be discovered as a top-level skill');
|
||||
|
||||
cleanup(skillsDir);
|
||||
});
|
||||
|
||||
test('bug-929: discovers nested concretes even when router has no top-level SKILL.md', () => {
|
||||
// Edge case: a router dir has a skills/ subdir with concretes but no top-level SKILL.md.
|
||||
// The concrete skills should still be discovered.
|
||||
const skillsDir = fs.mkdtempSync(path.join(require('os').tmpdir(), 'gsd-router-only-skills-'));
|
||||
|
||||
// Router dir with skills/ but no SKILL.md of its own
|
||||
const concreteDir = path.join(skillsDir, 'gsd-ns-noroot', 'skills', 'orphan-skill');
|
||||
fs.mkdirSync(concreteDir, { recursive: true });
|
||||
fs.writeFileSync(path.join(concreteDir, 'SKILL.md'), [
|
||||
'---',
|
||||
'name: gsd-orphan',
|
||||
'description: Orphan skill under router without top-level SKILL.md',
|
||||
'---',
|
||||
'',
|
||||
'# gsd-orphan',
|
||||
].join('\n'));
|
||||
|
||||
const result = runGsdTools(['skill-manifest', '--skills-dir', skillsDir], tmpDir);
|
||||
assert.ok(result.success, `Command should succeed: ${result.error || result.output}`);
|
||||
|
||||
const manifest = JSON.parse(result.output);
|
||||
assert.deepStrictEqual(
|
||||
manifest.skills.map((s) => s.name).sort(),
|
||||
['gsd-orphan'],
|
||||
);
|
||||
assert.strictEqual(manifest.counts.skills, 1);
|
||||
|
||||
cleanup(skillsDir);
|
||||
});
|
||||
|
||||
test('bug-929: flat layout (no nested skills/ subdirs) still works correctly', () => {
|
||||
const skillsDir = fs.mkdtempSync(path.join(require('os').tmpdir(), 'gsd-flat-skills-'));
|
||||
|
||||
function writeFlat(name, description) {
|
||||
const dir = path.join(skillsDir, name);
|
||||
fs.mkdirSync(dir, { recursive: true });
|
||||
fs.writeFileSync(path.join(dir, 'SKILL.md'), [
|
||||
'---',
|
||||
`name: ${name}`,
|
||||
`description: ${description}`,
|
||||
'---',
|
||||
'',
|
||||
`# ${name}`,
|
||||
].join('\n'));
|
||||
}
|
||||
|
||||
writeFlat('gsd-alpha', 'Alpha skill');
|
||||
writeFlat('gsd-beta', 'Beta skill');
|
||||
writeFlat('gsd-gamma', 'Gamma skill');
|
||||
|
||||
const result = runGsdTools(['skill-manifest', '--skills-dir', skillsDir], tmpDir);
|
||||
assert.ok(result.success, `Command should succeed: ${result.error || result.output}`);
|
||||
|
||||
const manifest = JSON.parse(result.output);
|
||||
assert.deepStrictEqual(
|
||||
manifest.skills.map((s) => s.name).sort(),
|
||||
['gsd-alpha', 'gsd-beta', 'gsd-gamma']
|
||||
);
|
||||
assert.strictEqual(manifest.counts.skills, 3, 'flat layout count should be exact, no phantom nesting');
|
||||
|
||||
cleanup(skillsDir);
|
||||
});
|
||||
|
||||
test('bug-929: non-gsd-ns-* dirs with a skills/ subdir are NOT scanned (guard)', () => {
|
||||
// Regression guard for the `if (!entry.name.startsWith('gsd-ns-')) continue;` guard
|
||||
// in buildSkillManifest. A user tool dir like `my-tool/` that happens to have its
|
||||
// own `skills/` subdirectory must NOT have those skills vacuumed up.
|
||||
// Only `gsd-ns-<router>/skills/<stem>/SKILL.md` paths are in scope.
|
||||
const skillsDir = fs.mkdtempSync(path.join(require('os').tmpdir(), 'gsd-guard-test-'));
|
||||
|
||||
// Non-router dir with a flat SKILL.md at its own root — SHOULD be found (flat scan).
|
||||
const topLevelDir = path.join(skillsDir, 'my-tool');
|
||||
fs.mkdirSync(topLevelDir, { recursive: true });
|
||||
fs.writeFileSync(path.join(topLevelDir, 'SKILL.md'), [
|
||||
'---',
|
||||
'name: my-tool',
|
||||
'description: A user-defined top-level skill',
|
||||
'---',
|
||||
'',
|
||||
'# my-tool',
|
||||
].join('\n'));
|
||||
|
||||
// Non-router dir with a nested skills/ subdir — nested skills must NOT be discovered.
|
||||
const nestedDir = path.join(skillsDir, 'my-tool', 'skills', 'helper');
|
||||
fs.mkdirSync(nestedDir, { recursive: true });
|
||||
fs.writeFileSync(path.join(nestedDir, 'SKILL.md'), [
|
||||
'---',
|
||||
'name: my-tool-helper',
|
||||
'description: A nested skill that must not be vacuumed up',
|
||||
'---',
|
||||
'',
|
||||
'# my-tool-helper',
|
||||
].join('\n'));
|
||||
|
||||
// Another non-router dir (prefixed differently, could look router-like but isn't)
|
||||
const otherDir = path.join(skillsDir, 'gsd-settings');
|
||||
fs.mkdirSync(otherDir, { recursive: true });
|
||||
fs.writeFileSync(path.join(otherDir, 'SKILL.md'), [
|
||||
'---',
|
||||
'name: gsd-settings',
|
||||
'description: A flat gsd-* skill that is not a router',
|
||||
'---',
|
||||
'',
|
||||
'# gsd-settings',
|
||||
].join('\n'));
|
||||
// Give gsd-settings its own skills/ subdir — must not be traversed since it's not gsd-ns-*
|
||||
const otherNestedDir = path.join(skillsDir, 'gsd-settings', 'skills', 'subsetting');
|
||||
fs.mkdirSync(otherNestedDir, { recursive: true });
|
||||
fs.writeFileSync(path.join(otherNestedDir, 'SKILL.md'), [
|
||||
'---',
|
||||
'name: gsd-subsetting',
|
||||
'description: A nested skill that must not be vacuumed up',
|
||||
'---',
|
||||
'',
|
||||
'# gsd-subsetting',
|
||||
].join('\n'));
|
||||
|
||||
const result = runGsdTools(['skill-manifest', '--skills-dir', skillsDir], tmpDir);
|
||||
assert.ok(result.success, `Command should succeed: ${result.error || result.output}`);
|
||||
|
||||
const manifest = JSON.parse(result.output);
|
||||
const skillNames = manifest.skills.map((s) => s.name).sort();
|
||||
|
||||
// Only the flat top-level SKILL.md entries should be found; nested non-router skills are ignored
|
||||
assert.deepStrictEqual(
|
||||
skillNames,
|
||||
['gsd-settings', 'my-tool'],
|
||||
'nested skills under non-gsd-ns-* dirs must not be discovered',
|
||||
);
|
||||
assert.strictEqual(
|
||||
manifest.counts.skills,
|
||||
2,
|
||||
'only 2 top-level skills; nested non-router helpers must not inflate the count',
|
||||
);
|
||||
|
||||
// Confirm the forbidden names are absent
|
||||
assert.ok(
|
||||
!skillNames.includes('my-tool-helper'),
|
||||
'my-tool/skills/helper/SKILL.md must not appear (guard: my-tool is not gsd-ns-*)',
|
||||
);
|
||||
assert.ok(
|
||||
!skillNames.includes('gsd-subsetting'),
|
||||
'gsd-settings/skills/subsetting/SKILL.md must not appear (guard: gsd-settings is not gsd-ns-*)',
|
||||
);
|
||||
|
||||
cleanup(skillsDir);
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user