@winspan/claude-forge 8.51.1 → 8.53.2
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/CLAUDE.md +5 -5
- package/dist/cli/commands/skills.d.ts.map +1 -1
- package/dist/cli/commands/skills.js +115 -0
- package/dist/cli/commands/skills.js.map +1 -1
- package/dist/core/constants.d.ts +2 -0
- package/dist/core/constants.d.ts.map +1 -1
- package/dist/core/constants.js +4 -0
- package/dist/core/constants.js.map +1 -1
- package/dist/daemon/index.d.ts.map +1 -1
- package/dist/daemon/index.js +11 -1
- package/dist/daemon/index.js.map +1 -1
- package/dist/daemon/skill-sync.d.ts +21 -0
- package/dist/daemon/skill-sync.d.ts.map +1 -0
- package/dist/daemon/skill-sync.js +75 -0
- package/dist/daemon/skill-sync.js.map +1 -0
- package/dist/hooks/notification.sh +1 -1
- package/dist/hooks/post-tool-use.sh +1 -1
- package/dist/hooks/pre-tool-use.sh +1 -1
- package/dist/hooks/stop.sh +1 -1
- package/dist/hooks/user-prompt-submit.sh +1 -1
- package/dist/skills/official/code-simplifier.md +37 -1
- package/dist/skills/official/find-skills.md +120 -1
- package/dist/skills/official/official-api-design.md +14 -1
- package/dist/skills/official/official-architecture-decision.md +22 -1
- package/dist/skills/official/official-db-schema-design.md +19 -1
- package/dist/skills/official/official-debug.md +9 -1
- package/dist/skills/official/official-pr-review.md +1 -1
- package/dist/skills/official/official-security-hardening.md +7 -1
- package/dist/skills/official/planning-with-files.md +206 -2
- package/dist/skills/official/ui-ux-pro-max.md +88 -1
- package/dist/skills/official/webapp-testing.md +85 -1
- package/dist/skills/registry.d.ts +1 -1
- package/dist/skills/registry.d.ts.map +1 -1
- package/dist/skills/registry.js +2 -2
- package/dist/skills/registry.js.map +1 -1
- package/dist/skills/semantic-matcher.d.ts +2 -1
- package/dist/skills/semantic-matcher.d.ts.map +1 -1
- package/dist/skills/semantic-matcher.js +6 -3
- package/dist/skills/semantic-matcher.js.map +1 -1
- package/dist/skills/upgrade-engine.d.ts +91 -0
- package/dist/skills/upgrade-engine.d.ts.map +1 -0
- package/dist/skills/upgrade-engine.js +436 -0
- package/dist/skills/upgrade-engine.js.map +1 -0
- package/dist/skills/upgrade-prompt.d.ts +20 -0
- package/dist/skills/upgrade-prompt.d.ts.map +1 -0
- package/dist/skills/upgrade-prompt.js +75 -0
- package/dist/skills/upgrade-prompt.js.map +1 -0
- package/docs/design/skill-ai-upgrade-spec-20260518-1930.md +297 -0
- package/docs/implementation/daemon-skill-sync-changelog-20260518-2000.md +22 -0
- package/docs/implementation/skill-ai-upgrade-changelog-20260518-1930.md +49 -0
- package/package.json +1 -1
- package/src/cli/commands/skills.ts +143 -0
- package/src/core/constants.ts +5 -0
- package/src/daemon/index.ts +11 -1
- package/src/daemon/skill-sync.ts +88 -0
- package/src/hooks/notification.sh +1 -1
- package/src/hooks/post-tool-use.sh +1 -1
- package/src/hooks/pre-tool-use.sh +1 -1
- package/src/hooks/stop.sh +1 -1
- package/src/hooks/user-prompt-submit.sh +1 -1
- package/src/skills/official/code-simplifier.md +37 -1
- package/src/skills/official/find-skills.md +120 -1
- package/src/skills/official/official-api-design.md +14 -1
- package/src/skills/official/official-architecture-decision.md +22 -1
- package/src/skills/official/official-db-schema-design.md +19 -1
- package/src/skills/official/official-debug.md +9 -1
- package/src/skills/official/official-pr-review.md +1 -1
- package/src/skills/official/official-security-hardening.md +7 -1
- package/src/skills/official/planning-with-files.md +206 -2
- package/src/skills/official/ui-ux-pro-max.md +88 -1
- package/src/skills/official/webapp-testing.md +85 -1
- package/src/skills/registry.ts +2 -2
- package/src/skills/semantic-matcher.ts +6 -3
- package/src/skills/upgrade-engine.ts +541 -0
- package/src/skills/upgrade-prompt.ts +84 -0
- package/tests/unit/daemon/skill-sync.test.ts +75 -0
- package/tests/unit/skills/upgrade-engine-parse.test.ts +138 -0
- package/tests/unit/skills/upgrade-engine.test.ts +401 -0
- package/tests/unit/skills/upgrade-prompt.test.ts +89 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAY7D;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAuB,IAAI,GAAG,EAAE,CAAC;IACvC,eAAe,GAAgC,IAAI,CAAC;IAE5D,YAAY,MAAe;
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -19,10 +19,11 @@ export interface SemanticMatchContext {
|
|
|
19
19
|
*/
|
|
20
20
|
export declare class SemanticSkillMatcher {
|
|
21
21
|
private client;
|
|
22
|
+
private model;
|
|
22
23
|
private cache;
|
|
23
24
|
private readonly CACHE_TTL;
|
|
24
25
|
private cacheTimestamps;
|
|
25
|
-
constructor(apiKey?: string);
|
|
26
|
+
constructor(apiKey?: string, model?: string, baseURL?: string);
|
|
26
27
|
/**
|
|
27
28
|
* Match skills using semantic understanding
|
|
28
29
|
* Falls back to keyword matching if API is not configured
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"semantic-matcher.d.ts","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"semantic-matcher.d.ts","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAsD;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,eAAe,CAAkC;gBAE7C,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAO7D;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAwBhG;;OAEG;YACW,WAAW;IAkCzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}
|
|
@@ -4,17 +4,20 @@
|
|
|
4
4
|
*/
|
|
5
5
|
import Anthropic from '@anthropic-ai/sdk';
|
|
6
6
|
import { logger } from '../core/utils/logger.js';
|
|
7
|
+
import { DEFAULTS } from '../core/constants.js';
|
|
7
8
|
/**
|
|
8
9
|
* Semantic matcher using Claude API for intent understanding
|
|
9
10
|
*/
|
|
10
11
|
export class SemanticSkillMatcher {
|
|
11
12
|
client = null;
|
|
13
|
+
model;
|
|
12
14
|
cache = new Map();
|
|
13
15
|
CACHE_TTL = 5 * 60 * 1000; // 5 minutes
|
|
14
16
|
cacheTimestamps = new Map();
|
|
15
|
-
constructor(apiKey) {
|
|
17
|
+
constructor(apiKey, model, baseURL) {
|
|
18
|
+
this.model = model || DEFAULTS.AI_MODEL;
|
|
16
19
|
if (apiKey) {
|
|
17
|
-
this.client = new Anthropic({ apiKey });
|
|
20
|
+
this.client = new Anthropic({ apiKey, baseURL });
|
|
18
21
|
}
|
|
19
22
|
}
|
|
20
23
|
/**
|
|
@@ -56,7 +59,7 @@ export class SemanticSkillMatcher {
|
|
|
56
59
|
.join('\n');
|
|
57
60
|
const prompt = this.buildMatchingPrompt(context, skillDescriptions);
|
|
58
61
|
const response = await this.client.messages.create({
|
|
59
|
-
model:
|
|
62
|
+
model: this.model,
|
|
60
63
|
max_tokens: 500,
|
|
61
64
|
temperature: 0,
|
|
62
65
|
messages: [
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"semantic-matcher.js","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;
|
|
1
|
+
{"version":3,"file":"semantic-matcher.js","sourceRoot":"","sources":["../../src/skills/semantic-matcher.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* upgrade-engine.ts
|
|
3
|
+
*
|
|
4
|
+
* Orchestrates the AI-assisted official skill upgrade pipeline.
|
|
5
|
+
* Does NOT contain AI prompt strings — those live in upgrade-prompt.ts.
|
|
6
|
+
*/
|
|
7
|
+
import type { OfficialSkill } from './official-skills.js';
|
|
8
|
+
import type { ClaudeProvider } from '../core/ai/provider.js';
|
|
9
|
+
export interface CandidateSkill {
|
|
10
|
+
id: string;
|
|
11
|
+
source: string;
|
|
12
|
+
filePath: string;
|
|
13
|
+
name: string;
|
|
14
|
+
description: string;
|
|
15
|
+
keywords: string[];
|
|
16
|
+
content: string;
|
|
17
|
+
}
|
|
18
|
+
export interface MatchResult {
|
|
19
|
+
officialId: string;
|
|
20
|
+
score: number;
|
|
21
|
+
}
|
|
22
|
+
export type UpgradeAction = 'upgrade' | 'merge' | 'skip';
|
|
23
|
+
export interface UpgradeDecision {
|
|
24
|
+
action: UpgradeAction;
|
|
25
|
+
confidence: number;
|
|
26
|
+
reasoning: string;
|
|
27
|
+
merged_content: string | null;
|
|
28
|
+
}
|
|
29
|
+
export interface ReportEntry {
|
|
30
|
+
officialId: string;
|
|
31
|
+
candidateId: string;
|
|
32
|
+
candidateSource: string;
|
|
33
|
+
action: UpgradeAction | 'error' | 'needs_review';
|
|
34
|
+
confidence: number;
|
|
35
|
+
reasoning: string;
|
|
36
|
+
candidateFilePath: string;
|
|
37
|
+
merged_content: string | null;
|
|
38
|
+
}
|
|
39
|
+
export declare const DEFAULT_SOURCES: Array<{
|
|
40
|
+
name: string;
|
|
41
|
+
url: string;
|
|
42
|
+
}>;
|
|
43
|
+
/**
|
|
44
|
+
* Clone or pull each source into `candidatesDir/<source.name>/`, then scan
|
|
45
|
+
* all .md files and parse them into CandidateSkill objects.
|
|
46
|
+
* Individual source failures are caught and logged; they do not abort the run.
|
|
47
|
+
*/
|
|
48
|
+
export declare function pullCandidates(sources: Array<{
|
|
49
|
+
name: string;
|
|
50
|
+
url: string;
|
|
51
|
+
}>, candidatesDir: string): Promise<CandidateSkill[]>;
|
|
52
|
+
/**
|
|
53
|
+
* Match a candidate skill to the best official skill using keyword + name token
|
|
54
|
+
* overlap. Returns null if the best score is below the 30-point threshold.
|
|
55
|
+
*/
|
|
56
|
+
export declare function matchToOfficial(candidate: CandidateSkill, officialSkills: OfficialSkill[]): MatchResult | null;
|
|
57
|
+
/**
|
|
58
|
+
* Ask the AI provider to evaluate whether a candidate should upgrade / merge /
|
|
59
|
+
* skip the matched official skill. Returns a parsed UpgradeDecision.
|
|
60
|
+
*
|
|
61
|
+
* On JSON parse failure → returns { action: 'skip', confidence: 0, reasoning:
|
|
62
|
+
* 'AI response could not be parsed', merged_content: null } with needs_review=true
|
|
63
|
+
* embedded in the reasoning (caller promotes to needs_review).
|
|
64
|
+
*/
|
|
65
|
+
export declare function evaluateWithAI(candidate: CandidateSkill, official: OfficialSkill, aiProvider: ClaudeProvider): Promise<UpgradeDecision & {
|
|
66
|
+
needs_review?: boolean;
|
|
67
|
+
}>;
|
|
68
|
+
/**
|
|
69
|
+
* Write the upgrade report as a markdown file with embedded HTML comment
|
|
70
|
+
* machine markers for `applyDecisions` to parse.
|
|
71
|
+
*/
|
|
72
|
+
export declare function generateReport(entries: ReportEntry[], outputPath: string, stats: {
|
|
73
|
+
total: number;
|
|
74
|
+
matched: number;
|
|
75
|
+
unmatched: number;
|
|
76
|
+
}): Promise<void>;
|
|
77
|
+
/**
|
|
78
|
+
* Apply the decisions recorded in a report file to the official skills directory.
|
|
79
|
+
*
|
|
80
|
+
* Safety checks:
|
|
81
|
+
* 1. `git status --porcelain <officialDir>` must be clean
|
|
82
|
+
* 2. Full backup created in `backupBaseDir/<YYYYMMDD-HHMM>/` (conflict → -2/-3)
|
|
83
|
+
*
|
|
84
|
+
* Returns { applied, skipped, backupPath }.
|
|
85
|
+
*/
|
|
86
|
+
export declare function applyDecisions(reportPath: string, officialDir: string, backupBaseDir: string): Promise<{
|
|
87
|
+
applied: number;
|
|
88
|
+
skipped: number;
|
|
89
|
+
backupPath: string;
|
|
90
|
+
}>;
|
|
91
|
+
//# sourceMappingURL=upgrade-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"upgrade-engine.d.ts","sourceRoot":"","sources":["../../src/skills/upgrade-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAO7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAID,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAGhE,CAAC;AA6EF;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,aAAa,EAAE,GAC9B,WAAW,GAAG,IAAI,CAgEpB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,eAAe,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyDvD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqHnE"}
|
|
@@ -0,0 +1,436 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* upgrade-engine.ts
|
|
3
|
+
*
|
|
4
|
+
* Orchestrates the AI-assisted official skill upgrade pipeline.
|
|
5
|
+
* Does NOT contain AI prompt strings — those live in upgrade-prompt.ts.
|
|
6
|
+
*/
|
|
7
|
+
import { exec } from 'node:child_process';
|
|
8
|
+
import { promises as fs, readFileSync } from 'node:fs';
|
|
9
|
+
import path from 'node:path';
|
|
10
|
+
import { promisify } from 'node:util';
|
|
11
|
+
import matter from 'gray-matter';
|
|
12
|
+
import { buildEvaluationPrompt } from './upgrade-prompt.js';
|
|
13
|
+
import { logger } from '../core/utils/logger.js';
|
|
14
|
+
const execAsync = promisify(exec);
|
|
15
|
+
// ── Default candidate sources ───────────────────────────────────────────────
|
|
16
|
+
export const DEFAULT_SOURCES = [
|
|
17
|
+
{ name: 'agent-skills', url: 'https://github.com/addyosmani/agent-skills.git' },
|
|
18
|
+
{ name: 'superpowers', url: 'https://github.com/obra/superpowers.git' },
|
|
19
|
+
];
|
|
20
|
+
// ── Helpers ─────────────────────────────────────────────────────────────────
|
|
21
|
+
/**
|
|
22
|
+
* Parse a .md file into a CandidateSkill.
|
|
23
|
+
* If frontmatter is missing, falls back to filename-based id.
|
|
24
|
+
*/
|
|
25
|
+
function parseCandidateFile(filePath, sourceName) {
|
|
26
|
+
try {
|
|
27
|
+
const raw = readFileSync(filePath, 'utf-8');
|
|
28
|
+
const parsed = matter(raw);
|
|
29
|
+
const { data } = parsed;
|
|
30
|
+
const fileName = path.basename(filePath, '.md');
|
|
31
|
+
const id = typeof data.name === 'string' ? data.name : fileName;
|
|
32
|
+
const name = typeof data.name === 'string' ? data.name : fileName;
|
|
33
|
+
const description = typeof data.description === 'string' ? data.description : '';
|
|
34
|
+
const rawKeywords = data.keywords ?? data.tags;
|
|
35
|
+
const keywords = Array.isArray(rawKeywords)
|
|
36
|
+
? rawKeywords.filter((k) => typeof k === 'string')
|
|
37
|
+
: [];
|
|
38
|
+
return {
|
|
39
|
+
id,
|
|
40
|
+
source: sourceName,
|
|
41
|
+
filePath,
|
|
42
|
+
name,
|
|
43
|
+
description,
|
|
44
|
+
keywords,
|
|
45
|
+
content: raw,
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Recursively scan a directory for .md files.
|
|
54
|
+
* Supports both directory/SKILL.md format (agent-skills) and flat *.md format.
|
|
55
|
+
*/
|
|
56
|
+
async function scanMdFiles(dir) {
|
|
57
|
+
const results = [];
|
|
58
|
+
async function walk(current) {
|
|
59
|
+
let entries;
|
|
60
|
+
try {
|
|
61
|
+
entries = await fs.readdir(current, { withFileTypes: true });
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
for (const entry of entries) {
|
|
67
|
+
const fullPath = path.join(current, entry.name);
|
|
68
|
+
if (entry.isDirectory()) {
|
|
69
|
+
// Check for SKILL.md inside this directory (agent-skills format)
|
|
70
|
+
const skillMd = path.join(fullPath, 'SKILL.md');
|
|
71
|
+
try {
|
|
72
|
+
await fs.access(skillMd);
|
|
73
|
+
results.push(skillMd);
|
|
74
|
+
}
|
|
75
|
+
catch {
|
|
76
|
+
// Recurse into sub-directories that don't have SKILL.md directly
|
|
77
|
+
await walk(fullPath);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
|
|
81
|
+
results.push(fullPath);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
await walk(dir);
|
|
86
|
+
return results;
|
|
87
|
+
}
|
|
88
|
+
// ── Exported pipeline functions ─────────────────────────────────────────────
|
|
89
|
+
/**
|
|
90
|
+
* Clone or pull each source into `candidatesDir/<source.name>/`, then scan
|
|
91
|
+
* all .md files and parse them into CandidateSkill objects.
|
|
92
|
+
* Individual source failures are caught and logged; they do not abort the run.
|
|
93
|
+
*/
|
|
94
|
+
export async function pullCandidates(sources, candidatesDir) {
|
|
95
|
+
await fs.mkdir(candidatesDir, { recursive: true });
|
|
96
|
+
const candidates = [];
|
|
97
|
+
for (const source of sources) {
|
|
98
|
+
const targetDir = path.join(candidatesDir, source.name);
|
|
99
|
+
let exists = false;
|
|
100
|
+
try {
|
|
101
|
+
await fs.access(targetDir);
|
|
102
|
+
exists = true;
|
|
103
|
+
}
|
|
104
|
+
catch { /* not exists */ }
|
|
105
|
+
// Try pull/clone, but don't abort scan if pull fails on existing dir
|
|
106
|
+
try {
|
|
107
|
+
if (exists) {
|
|
108
|
+
logger.info(`[upgrade] Pulling ${source.name}...`);
|
|
109
|
+
await execAsync(`git -C "${targetDir}" pull --ff-only`, { timeout: 60_000 });
|
|
110
|
+
}
|
|
111
|
+
else {
|
|
112
|
+
logger.info(`[upgrade] Cloning ${source.name}...`);
|
|
113
|
+
await execAsync(`git clone --depth=1 "${source.url}" "${targetDir}"`, { timeout: 120_000 });
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
catch (err) {
|
|
117
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
118
|
+
if (exists) {
|
|
119
|
+
logger.warn(`[upgrade] ${source.name} pull failed (using existing checkout): ${msg}`);
|
|
120
|
+
}
|
|
121
|
+
else {
|
|
122
|
+
logger.warn(`[upgrade] ${source.name} clone failed, skipping: ${msg}`);
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
// Always scan if dir exists (even when pull fails — old checkout is better than nothing)
|
|
127
|
+
try {
|
|
128
|
+
const mdFiles = await scanMdFiles(targetDir);
|
|
129
|
+
for (const filePath of mdFiles) {
|
|
130
|
+
const candidate = parseCandidateFile(filePath, source.name);
|
|
131
|
+
if (candidate) {
|
|
132
|
+
candidates.push(candidate);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
logger.info(`[upgrade] ${source.name}: ${mdFiles.length} .md files found`);
|
|
136
|
+
}
|
|
137
|
+
catch (err) {
|
|
138
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
139
|
+
logger.warn(`[upgrade] Skipping source ${source.name}: ${msg}`);
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
return candidates;
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Match a candidate skill to the best official skill using keyword + name token
|
|
146
|
+
* overlap. Returns null if the best score is below the 30-point threshold.
|
|
147
|
+
*/
|
|
148
|
+
export function matchToOfficial(candidate, officialSkills) {
|
|
149
|
+
/** Tokenise a string into lowercase words / tokens. */
|
|
150
|
+
function tokenise(text) {
|
|
151
|
+
return new Set(text
|
|
152
|
+
.toLowerCase()
|
|
153
|
+
.replace(/[^a-z0-9一-鿿\s-]/g, ' ')
|
|
154
|
+
.split(/[\s-]+/)
|
|
155
|
+
.filter((t) => t.length > 1));
|
|
156
|
+
}
|
|
157
|
+
/** Jaccard-like overlap score (0–100). */
|
|
158
|
+
function overlapScore(aSet, bSet) {
|
|
159
|
+
if (aSet.size === 0 && bSet.size === 0)
|
|
160
|
+
return 0;
|
|
161
|
+
let intersection = 0;
|
|
162
|
+
for (const t of aSet) {
|
|
163
|
+
if (bSet.has(t))
|
|
164
|
+
intersection++;
|
|
165
|
+
}
|
|
166
|
+
const union = new Set([...aSet, ...bSet]).size;
|
|
167
|
+
return union === 0 ? 0 : Math.round((intersection / union) * 100);
|
|
168
|
+
}
|
|
169
|
+
const candidateKeywordTokens = tokenise(candidate.keywords.join(' '));
|
|
170
|
+
const candidateNameTokens = tokenise(candidate.name + ' ' + candidate.description);
|
|
171
|
+
let best = null;
|
|
172
|
+
for (const official of officialSkills) {
|
|
173
|
+
const officialKeywordTokens = tokenise(official.keywords.join(' '));
|
|
174
|
+
const officialNameTokens = tokenise(official.name + ' ' + official.description);
|
|
175
|
+
// keyword overlap (weight 60) + name/description token overlap (weight 40)
|
|
176
|
+
const keywordScore = overlapScore(candidateKeywordTokens, officialKeywordTokens);
|
|
177
|
+
const nameScore = overlapScore(candidateNameTokens, officialNameTokens);
|
|
178
|
+
let combined = Math.round(keywordScore * 0.6 + nameScore * 0.4);
|
|
179
|
+
// Substring boost: candidate id/name contains official keyword (or vice versa)
|
|
180
|
+
// helps with English↔中文 token mismatch (e.g. "debugging" ↔ "debug"/"调试")
|
|
181
|
+
const candidateText = (candidate.id + ' ' + candidate.name + ' ' + candidate.description).toLowerCase();
|
|
182
|
+
const officialText = (official.name + ' ' + official.description).toLowerCase();
|
|
183
|
+
for (const kw of official.keywords) {
|
|
184
|
+
const kwLower = kw.toLowerCase();
|
|
185
|
+
if (kwLower.length >= 3 && candidateText.includes(kwLower)) {
|
|
186
|
+
combined = Math.max(combined, 50);
|
|
187
|
+
break;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
for (const kw of candidate.keywords) {
|
|
191
|
+
const kwLower = kw.toLowerCase();
|
|
192
|
+
if (kwLower.length >= 3 && officialText.includes(kwLower)) {
|
|
193
|
+
combined = Math.max(combined, 50);
|
|
194
|
+
break;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
if (combined >= 15) {
|
|
198
|
+
if (!best || combined > best.score) {
|
|
199
|
+
best = { officialId: official.name, score: combined };
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
return best;
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* Ask the AI provider to evaluate whether a candidate should upgrade / merge /
|
|
207
|
+
* skip the matched official skill. Returns a parsed UpgradeDecision.
|
|
208
|
+
*
|
|
209
|
+
* On JSON parse failure → returns { action: 'skip', confidence: 0, reasoning:
|
|
210
|
+
* 'AI response could not be parsed', merged_content: null } with needs_review=true
|
|
211
|
+
* embedded in the reasoning (caller promotes to needs_review).
|
|
212
|
+
*/
|
|
213
|
+
export async function evaluateWithAI(candidate, official, aiProvider) {
|
|
214
|
+
const { system, user } = buildEvaluationPrompt(candidate, official);
|
|
215
|
+
let raw;
|
|
216
|
+
try {
|
|
217
|
+
raw = await aiProvider.complete(user, {
|
|
218
|
+
system,
|
|
219
|
+
maxTokens: 1200,
|
|
220
|
+
timeoutMs: 45_000,
|
|
221
|
+
maxRetries: 2,
|
|
222
|
+
});
|
|
223
|
+
}
|
|
224
|
+
catch (err) {
|
|
225
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
226
|
+
return {
|
|
227
|
+
action: 'skip',
|
|
228
|
+
confidence: 0,
|
|
229
|
+
reasoning: `AI 调用失败: ${msg}`,
|
|
230
|
+
merged_content: null,
|
|
231
|
+
needs_review: true,
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
// Strip markdown code fences if model wrapped the JSON
|
|
235
|
+
const stripped = raw
|
|
236
|
+
.replace(/^```(?:json)?\s*/im, '')
|
|
237
|
+
.replace(/\s*```$/im, '')
|
|
238
|
+
.trim();
|
|
239
|
+
try {
|
|
240
|
+
const parsed = JSON.parse(stripped);
|
|
241
|
+
const validActions = new Set(['upgrade', 'merge', 'skip']);
|
|
242
|
+
const action = typeof parsed.action === 'string' && validActions.has(parsed.action)
|
|
243
|
+
? parsed.action
|
|
244
|
+
: 'skip';
|
|
245
|
+
const confidence = typeof parsed.confidence === 'number'
|
|
246
|
+
? Math.max(0, Math.min(100, parsed.confidence))
|
|
247
|
+
: 0;
|
|
248
|
+
const reasoning = typeof parsed.reasoning === 'string' ? parsed.reasoning : '';
|
|
249
|
+
const merged_content = typeof parsed.merged_content === 'string' ? parsed.merged_content : null;
|
|
250
|
+
return { action, confidence, reasoning, merged_content };
|
|
251
|
+
}
|
|
252
|
+
catch {
|
|
253
|
+
return {
|
|
254
|
+
action: 'skip',
|
|
255
|
+
confidence: 0,
|
|
256
|
+
reasoning: `AI 返回内容无法解析为 JSON,需人工审核。原始响应片段: ${stripped.slice(0, 200)}`,
|
|
257
|
+
merged_content: null,
|
|
258
|
+
needs_review: true,
|
|
259
|
+
};
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
/**
|
|
263
|
+
* Write the upgrade report as a markdown file with embedded HTML comment
|
|
264
|
+
* machine markers for `applyDecisions` to parse.
|
|
265
|
+
*/
|
|
266
|
+
export async function generateReport(entries, outputPath, stats) {
|
|
267
|
+
const now = new Date();
|
|
268
|
+
const timestamp = now.toISOString().replace('T', ' ').slice(0, 16);
|
|
269
|
+
const actionCounts = { upgrade: 0, merge: 0, skip: 0, error: 0, needs_review: 0 };
|
|
270
|
+
for (const e of entries) {
|
|
271
|
+
if (e.action in actionCounts) {
|
|
272
|
+
actionCounts[e.action]++;
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
const lines = [
|
|
276
|
+
'# Skill Upgrade Report',
|
|
277
|
+
'',
|
|
278
|
+
`Generated: ${timestamp}`,
|
|
279
|
+
'',
|
|
280
|
+
'## Summary',
|
|
281
|
+
'',
|
|
282
|
+
'| Metric | Count |',
|
|
283
|
+
'|--------|-------|',
|
|
284
|
+
`| Candidates scanned | ${stats.total} |`,
|
|
285
|
+
`| Matched to official | ${stats.matched} |`,
|
|
286
|
+
`| Action: upgrade | ${actionCounts.upgrade} |`,
|
|
287
|
+
`| Action: merge | ${actionCounts.merge} |`,
|
|
288
|
+
`| Action: skip | ${actionCounts.skip} |`,
|
|
289
|
+
`| Needs review | ${actionCounts.needs_review} |`,
|
|
290
|
+
`| Error | ${actionCounts.error} |`,
|
|
291
|
+
`| Unmatched | ${stats.unmatched} |`,
|
|
292
|
+
'',
|
|
293
|
+
'## Per-Skill Decisions',
|
|
294
|
+
'',
|
|
295
|
+
];
|
|
296
|
+
for (const entry of entries) {
|
|
297
|
+
lines.push(`### ${entry.officialId}`);
|
|
298
|
+
lines.push(`- **Action**: ${entry.action}`);
|
|
299
|
+
lines.push(`- **Confidence**: ${entry.confidence}%`);
|
|
300
|
+
lines.push(`- **Candidate**: \`${entry.candidateSource}/${entry.candidateId}\``);
|
|
301
|
+
lines.push(`- **Candidate path**: \`${entry.candidateFilePath}\``);
|
|
302
|
+
lines.push(`- **Reasoning**: ${entry.reasoning}`);
|
|
303
|
+
// Machine-readable marker for applyDecisions
|
|
304
|
+
lines.push('');
|
|
305
|
+
lines.push(`<!-- upgrade-entry: ${entry.officialId} | ${entry.candidateFilePath} | ${entry.action} -->`);
|
|
306
|
+
if (entry.action === 'merge' && entry.merged_content) {
|
|
307
|
+
lines.push('');
|
|
308
|
+
lines.push('<!-- merged-content-begin -->');
|
|
309
|
+
lines.push(entry.merged_content);
|
|
310
|
+
lines.push('<!-- merged-content-end -->');
|
|
311
|
+
}
|
|
312
|
+
lines.push('');
|
|
313
|
+
}
|
|
314
|
+
await fs.mkdir(path.dirname(outputPath), { recursive: true });
|
|
315
|
+
await fs.writeFile(outputPath, lines.join('\n'), 'utf-8');
|
|
316
|
+
logger.info(`[upgrade] Report written to ${outputPath}`);
|
|
317
|
+
}
|
|
318
|
+
/**
|
|
319
|
+
* Apply the decisions recorded in a report file to the official skills directory.
|
|
320
|
+
*
|
|
321
|
+
* Safety checks:
|
|
322
|
+
* 1. `git status --porcelain <officialDir>` must be clean
|
|
323
|
+
* 2. Full backup created in `backupBaseDir/<YYYYMMDD-HHMM>/` (conflict → -2/-3)
|
|
324
|
+
*
|
|
325
|
+
* Returns { applied, skipped, backupPath }.
|
|
326
|
+
*/
|
|
327
|
+
export async function applyDecisions(reportPath, officialDir, backupBaseDir) {
|
|
328
|
+
// 1. Check git working tree is clean
|
|
329
|
+
try {
|
|
330
|
+
const { stdout } = await execAsync(`git status --porcelain "${officialDir}"`);
|
|
331
|
+
if (stdout.trim().length > 0) {
|
|
332
|
+
throw new Error(`Working tree is dirty in ${officialDir}. Commit or stash changes before applying.\n${stdout}`);
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
catch (err) {
|
|
336
|
+
// If git is not available or it's not a repo, rethrow only for dirty-tree errors
|
|
337
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
338
|
+
if (msg.includes('Working tree is dirty'))
|
|
339
|
+
throw err;
|
|
340
|
+
logger.warn(`[upgrade] git status check failed (not a git repo?): ${msg}`);
|
|
341
|
+
}
|
|
342
|
+
// 2. Create timestamped backup directory
|
|
343
|
+
const ts = new Date()
|
|
344
|
+
.toISOString()
|
|
345
|
+
.replace(/[-:]/g, '')
|
|
346
|
+
.replace('T', '-')
|
|
347
|
+
.slice(0, 13); // YYYYMMDD-HHM -> need YYYYMMDD-HHMM format
|
|
348
|
+
const tsFormatted = (() => {
|
|
349
|
+
const d = new Date();
|
|
350
|
+
const YYYY = d.getFullYear();
|
|
351
|
+
const MM = String(d.getMonth() + 1).padStart(2, '0');
|
|
352
|
+
const DD = String(d.getDate()).padStart(2, '0');
|
|
353
|
+
const HH = String(d.getHours()).padStart(2, '0');
|
|
354
|
+
const mm = String(d.getMinutes()).padStart(2, '0');
|
|
355
|
+
return `${YYYY}${MM}${DD}-${HH}${mm}`;
|
|
356
|
+
})();
|
|
357
|
+
let backupPath = path.join(backupBaseDir, tsFormatted);
|
|
358
|
+
// Handle conflict: try -2, -3, ...
|
|
359
|
+
let suffix = 2;
|
|
360
|
+
while (true) {
|
|
361
|
+
try {
|
|
362
|
+
await fs.access(backupPath);
|
|
363
|
+
// Directory exists — try next suffix
|
|
364
|
+
backupPath = path.join(backupBaseDir, `${tsFormatted}-${suffix}`);
|
|
365
|
+
suffix++;
|
|
366
|
+
}
|
|
367
|
+
catch {
|
|
368
|
+
break; // doesn't exist, we can use it
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
await fs.mkdir(backupPath, { recursive: true });
|
|
372
|
+
// Copy all .md files from officialDir into backup
|
|
373
|
+
const officialFiles = (await fs.readdir(officialDir)).filter((f) => f.endsWith('.md'));
|
|
374
|
+
for (const file of officialFiles) {
|
|
375
|
+
await fs.copyFile(path.join(officialDir, file), path.join(backupPath, file));
|
|
376
|
+
}
|
|
377
|
+
logger.info(`[upgrade] Backed up ${officialFiles.length} files to ${backupPath}`);
|
|
378
|
+
// 3. Parse report
|
|
379
|
+
const reportContent = await fs.readFile(reportPath, 'utf-8');
|
|
380
|
+
// Parse <!-- upgrade-entry: id | path | action --> markers
|
|
381
|
+
const entryPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| (.+?) -->/g;
|
|
382
|
+
let match;
|
|
383
|
+
const entries = [];
|
|
384
|
+
while ((match = entryPattern.exec(reportContent)) !== null) {
|
|
385
|
+
entries.push({
|
|
386
|
+
officialId: match[1].trim(),
|
|
387
|
+
candidatePath: match[2].trim(),
|
|
388
|
+
action: match[3].trim(),
|
|
389
|
+
});
|
|
390
|
+
}
|
|
391
|
+
// Parse merged content blocks
|
|
392
|
+
const mergedContentMap = new Map();
|
|
393
|
+
// Associate merged-content blocks with the preceding entry
|
|
394
|
+
const mergedPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| merge -->[\s\S]*?<!-- merged-content-begin -->\n([\s\S]*?)\n<!-- merged-content-end -->/g;
|
|
395
|
+
while ((match = mergedPattern.exec(reportContent)) !== null) {
|
|
396
|
+
mergedContentMap.set(match[1].trim(), match[3]);
|
|
397
|
+
}
|
|
398
|
+
let applied = 0;
|
|
399
|
+
let skipped = 0;
|
|
400
|
+
for (const entry of entries) {
|
|
401
|
+
if (entry.action === 'skip' || entry.action === 'error' || entry.action === 'needs_review') {
|
|
402
|
+
skipped++;
|
|
403
|
+
continue;
|
|
404
|
+
}
|
|
405
|
+
const targetFile = path.join(officialDir, `${entry.officialId}.md`);
|
|
406
|
+
try {
|
|
407
|
+
if (entry.action === 'upgrade') {
|
|
408
|
+
// Copy candidate file content
|
|
409
|
+
const candidateContent = await fs.readFile(entry.candidatePath, 'utf-8');
|
|
410
|
+
await fs.writeFile(targetFile, candidateContent, 'utf-8');
|
|
411
|
+
applied++;
|
|
412
|
+
logger.info(`[upgrade] Applied upgrade: ${entry.officialId}`);
|
|
413
|
+
}
|
|
414
|
+
else if (entry.action === 'merge') {
|
|
415
|
+
const mergedContent = mergedContentMap.get(entry.officialId);
|
|
416
|
+
if (mergedContent) {
|
|
417
|
+
await fs.writeFile(targetFile, mergedContent, 'utf-8');
|
|
418
|
+
applied++;
|
|
419
|
+
logger.info(`[upgrade] Applied merge: ${entry.officialId}`);
|
|
420
|
+
}
|
|
421
|
+
else {
|
|
422
|
+
logger.warn(`[upgrade] Merge entry ${entry.officialId} has no merged content; skipping`);
|
|
423
|
+
skipped++;
|
|
424
|
+
}
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
catch (err) {
|
|
428
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
429
|
+
logger.error(`[upgrade] Failed to apply ${entry.officialId}: ${msg}`);
|
|
430
|
+
skipped++;
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
logger.info(`[upgrade] Apply complete: ${applied} applied, ${skipped} skipped`);
|
|
434
|
+
return { applied, skipped, backupPath };
|
|
435
|
+
}
|
|
436
|
+
//# sourceMappingURL=upgrade-engine.js.map
|