agent-plugkit 0.1.0

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.
Files changed (156) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +295 -0
  3. package/dist/adapters/agent-plugins.d.ts +35 -0
  4. package/dist/adapters/agent-plugins.js +57 -0
  5. package/dist/adapters/agent-plugins.js.map +1 -0
  6. package/dist/adapters/claude.d.ts +64 -0
  7. package/dist/adapters/claude.js +123 -0
  8. package/dist/adapters/claude.js.map +1 -0
  9. package/dist/adapters/cli-validation.d.ts +12 -0
  10. package/dist/adapters/cli-validation.js +31 -0
  11. package/dist/adapters/cli-validation.js.map +1 -0
  12. package/dist/adapters/codex.d.ts +62 -0
  13. package/dist/adapters/codex.js +91 -0
  14. package/dist/adapters/codex.js.map +1 -0
  15. package/dist/adapters/marketplace-registration.d.ts +17 -0
  16. package/dist/adapters/marketplace-registration.js +369 -0
  17. package/dist/adapters/marketplace-registration.js.map +1 -0
  18. package/dist/adapters/marketplace.d.ts +11 -0
  19. package/dist/adapters/marketplace.js +96 -0
  20. package/dist/adapters/marketplace.js.map +1 -0
  21. package/dist/adapters/mcp.d.ts +17 -0
  22. package/dist/adapters/mcp.js +28 -0
  23. package/dist/adapters/mcp.js.map +1 -0
  24. package/dist/application/artifact-generation.d.ts +58 -0
  25. package/dist/application/artifact-generation.js +344 -0
  26. package/dist/application/artifact-generation.js.map +1 -0
  27. package/dist/application/local-release.d.ts +122 -0
  28. package/dist/application/local-release.js +940 -0
  29. package/dist/application/local-release.js.map +1 -0
  30. package/dist/application/marketplace-document-contract.d.ts +81 -0
  31. package/dist/application/marketplace-document-contract.js +2 -0
  32. package/dist/application/marketplace-document-contract.js.map +1 -0
  33. package/dist/application/marketplace-document.d.ts +45 -0
  34. package/dist/application/marketplace-document.js +557 -0
  35. package/dist/application/marketplace-document.js.map +1 -0
  36. package/dist/application/marketplace-registration-contract.d.ts +51 -0
  37. package/dist/application/marketplace-registration-contract.js +11 -0
  38. package/dist/application/marketplace-registration-contract.js.map +1 -0
  39. package/dist/application/marketplace-registration.d.ts +20 -0
  40. package/dist/application/marketplace-registration.js +304 -0
  41. package/dist/application/marketplace-registration.js.map +1 -0
  42. package/dist/application/marketplace.d.ts +9 -0
  43. package/dist/application/marketplace.js +32 -0
  44. package/dist/application/marketplace.js.map +1 -0
  45. package/dist/application/plugin-components-contract.d.ts +135 -0
  46. package/dist/application/plugin-components-contract.js +2 -0
  47. package/dist/application/plugin-components-contract.js.map +1 -0
  48. package/dist/application/plugin-components.d.ts +17 -0
  49. package/dist/application/plugin-components.js +1000 -0
  50. package/dist/application/plugin-components.js.map +1 -0
  51. package/dist/application/plugin-document-contract.d.ts +115 -0
  52. package/dist/application/plugin-document-contract.js +2 -0
  53. package/dist/application/plugin-document-contract.js.map +1 -0
  54. package/dist/application/plugin-document.d.ts +69 -0
  55. package/dist/application/plugin-document.js +1037 -0
  56. package/dist/application/plugin-document.js.map +1 -0
  57. package/dist/application/plugin-lifecycle-contract.d.ts +230 -0
  58. package/dist/application/plugin-lifecycle-contract.js +3 -0
  59. package/dist/application/plugin-lifecycle-contract.js.map +1 -0
  60. package/dist/application/plugin-lifecycle.d.ts +8 -0
  61. package/dist/application/plugin-lifecycle.js +1375 -0
  62. package/dist/application/plugin-lifecycle.js.map +1 -0
  63. package/dist/application/plugin-scaffold.d.ts +18 -0
  64. package/dist/application/plugin-scaffold.js +188 -0
  65. package/dist/application/plugin-scaffold.js.map +1 -0
  66. package/dist/application/plugin-source.d.ts +39 -0
  67. package/dist/application/plugin-source.js +59 -0
  68. package/dist/application/plugin-source.js.map +1 -0
  69. package/dist/application/skill-document-contract.d.ts +92 -0
  70. package/dist/application/skill-document-contract.js +8 -0
  71. package/dist/application/skill-document-contract.js.map +1 -0
  72. package/dist/application/skill-document-guided.d.ts +3 -0
  73. package/dist/application/skill-document-guided.js +53 -0
  74. package/dist/application/skill-document-guided.js.map +1 -0
  75. package/dist/application/skill-document.d.ts +19 -0
  76. package/dist/application/skill-document.js +368 -0
  77. package/dist/application/skill-document.js.map +1 -0
  78. package/dist/application/workspace-create-contract.d.ts +50 -0
  79. package/dist/application/workspace-create-contract.js +16 -0
  80. package/dist/application/workspace-create-contract.js.map +1 -0
  81. package/dist/application/workspace-create.d.ts +8 -0
  82. package/dist/application/workspace-create.js +656 -0
  83. package/dist/application/workspace-create.js.map +1 -0
  84. package/dist/application/workspace-health-contract.d.ts +133 -0
  85. package/dist/application/workspace-health-contract.js +272 -0
  86. package/dist/application/workspace-health-contract.js.map +1 -0
  87. package/dist/application/workspace-health.d.ts +10 -0
  88. package/dist/application/workspace-health.js +1114 -0
  89. package/dist/application/workspace-health.js.map +1 -0
  90. package/dist/application/workspace-operation-contract.d.ts +99 -0
  91. package/dist/application/workspace-operation-contract.js +450 -0
  92. package/dist/application/workspace-operation-contract.js.map +1 -0
  93. package/dist/application/workspace-operation.d.ts +42 -0
  94. package/dist/application/workspace-operation.js +517 -0
  95. package/dist/application/workspace-operation.js.map +1 -0
  96. package/dist/cli.d.ts +16 -0
  97. package/dist/cli.js +136 -0
  98. package/dist/cli.js.map +1 -0
  99. package/dist/commands/add.d.ts +8 -0
  100. package/dist/commands/add.js +77 -0
  101. package/dist/commands/add.js.map +1 -0
  102. package/dist/commands/build.d.ts +7 -0
  103. package/dist/commands/build.js +29 -0
  104. package/dist/commands/build.js.map +1 -0
  105. package/dist/commands/component-scaffold.d.ts +4 -0
  106. package/dist/commands/component-scaffold.js +14 -0
  107. package/dist/commands/component-scaffold.js.map +1 -0
  108. package/dist/commands/import-skill.d.ts +15 -0
  109. package/dist/commands/import-skill.js +41 -0
  110. package/dist/commands/import-skill.js.map +1 -0
  111. package/dist/commands/index-gen.d.ts +12 -0
  112. package/dist/commands/index-gen.js +33 -0
  113. package/dist/commands/index-gen.js.map +1 -0
  114. package/dist/commands/init-repo.d.ts +8 -0
  115. package/dist/commands/init-repo.js +53 -0
  116. package/dist/commands/init-repo.js.map +1 -0
  117. package/dist/commands/init.d.ts +9 -0
  118. package/dist/commands/init.js +33 -0
  119. package/dist/commands/init.js.map +1 -0
  120. package/dist/commands/install-repo.d.ts +20 -0
  121. package/dist/commands/install-repo.js +200 -0
  122. package/dist/commands/install-repo.js.map +1 -0
  123. package/dist/commands/release-local.d.ts +9 -0
  124. package/dist/commands/release-local.js +27 -0
  125. package/dist/commands/release-local.js.map +1 -0
  126. package/dist/commands/validate.d.ts +8 -0
  127. package/dist/commands/validate.js +45 -0
  128. package/dist/commands/validate.js.map +1 -0
  129. package/dist/core/errors.d.ts +5 -0
  130. package/dist/core/errors.js +12 -0
  131. package/dist/core/errors.js.map +1 -0
  132. package/dist/generated/skill-content.d.ts +3 -0
  133. package/dist/generated/skill-content.js +9 -0
  134. package/dist/generated/skill-content.js.map +1 -0
  135. package/dist/infrastructure/authorized-path.d.ts +20 -0
  136. package/dist/infrastructure/authorized-path.js +85 -0
  137. package/dist/infrastructure/authorized-path.js.map +1 -0
  138. package/dist/infrastructure/document-commit.d.ts +165 -0
  139. package/dist/infrastructure/document-commit.js +1352 -0
  140. package/dist/infrastructure/document-commit.js.map +1 -0
  141. package/dist/infrastructure/process-runner.d.ts +29 -0
  142. package/dist/infrastructure/process-runner.js +130 -0
  143. package/dist/infrastructure/process-runner.js.map +1 -0
  144. package/dist/infrastructure/vscode-user-settings.d.ts +42 -0
  145. package/dist/infrastructure/vscode-user-settings.js +509 -0
  146. package/dist/infrastructure/vscode-user-settings.js.map +1 -0
  147. package/dist/schema/plugin-yaml.d.ts +89 -0
  148. package/dist/schema/plugin-yaml.js +241 -0
  149. package/dist/schema/plugin-yaml.js.map +1 -0
  150. package/dist/utils/frontmatter.d.ts +30 -0
  151. package/dist/utils/frontmatter.js +60 -0
  152. package/dist/utils/frontmatter.js.map +1 -0
  153. package/dist/utils/helpers.d.ts +44 -0
  154. package/dist/utils/helpers.js +94 -0
  155. package/dist/utils/helpers.js.map +1 -0
  156. package/package.json +56 -0
@@ -0,0 +1,368 @@
1
+ import { existsSync, lstatSync, readFileSync } from "node:fs";
2
+ import { relative, sep } from "node:path";
3
+ import { Document, isAlias, isMap, isScalar, parseDocument, } from "yaml";
4
+ import { AuthorizedPathError, authorizeExistingDirectory, resolveAuthorizedPath, } from "../infrastructure/authorized-path.js";
5
+ import { commitAuthorizedDocument, documentRevision, } from "../infrastructure/document-commit.js";
6
+ import { SKILL_DOCUMENT_FILENAME, } from "./skill-document-contract.js";
7
+ import { skillGuidedSections } from "./skill-document-guided.js";
8
+ export { skillGuidedSections, updateSkillGuidedSection } from "./skill-document-guided.js";
9
+ const UTF8_BOM = Buffer.from([0xef, 0xbb, 0xbf]);
10
+ const MAX_SKILL_DOCUMENT_BYTES = 5 * 1024 * 1024;
11
+ const RAW_PREVIEW_BYTES = 256 * 1024;
12
+ function problem(code, technicalDetail) {
13
+ const details = technicalDetail === undefined ? {} : { technicalDetail };
14
+ if (code === "SKILL_MISSING") {
15
+ return {
16
+ code,
17
+ title: "找不到 Skill 正文",
18
+ message: "当前 Skill 中没有可读取的 SKILL.md。",
19
+ impact: "正文编辑没有开始,也没有创建或修改文件。",
20
+ nextAction: "请先重新检查组件声明或在外部恢复这个文件。",
21
+ ...details,
22
+ };
23
+ }
24
+ if (code === "SKILL_UNSAFE") {
25
+ return {
26
+ code,
27
+ title: "Skill 正文的位置不安全",
28
+ message: "当前声明路径无法在已授权插件内安全解析。",
29
+ impact: "客户端已停止读取或保存,没有越过授权边界。",
30
+ nextAction: "请在组件声明中修正路径后重新打开正文。",
31
+ ...details,
32
+ };
33
+ }
34
+ if (code === "SKILL_UNAVAILABLE") {
35
+ return {
36
+ code,
37
+ title: "暂时无法读取 Skill 正文",
38
+ message: "SKILL.md 当前不可访问或不是普通文件。",
39
+ impact: "客户端没有修改正文或同目录其他内容。",
40
+ nextAction: "请检查本机权限和文件状态,然后重新加载。",
41
+ ...details,
42
+ };
43
+ }
44
+ if (code === "INVALID_ENCODING") {
45
+ return {
46
+ code,
47
+ title: "正文编码无法安全解释",
48
+ message: "SKILL.md 不是有效 UTF-8 文本。",
49
+ impact: "客户端只显示受限原始字节预览,不会覆盖原文件。",
50
+ nextAction: "请用外部编辑器转换为 UTF-8 后重新加载。",
51
+ ...details,
52
+ };
53
+ }
54
+ return {
55
+ code,
56
+ title: "正文 frontmatter 无法安全解释",
57
+ message: "SKILL.md 的开头配置不是可安全局部维护的 YAML mapping。",
58
+ impact: "客户端保留完整原文,只提供只读预览和外部修复入口。",
59
+ nextAction: "请用外部编辑器修正 frontmatter 后重新加载。",
60
+ ...details,
61
+ };
62
+ }
63
+ function decode(bytes) {
64
+ const bom = bytes.subarray(0, 3).equals(UTF8_BOM);
65
+ const content = bom ? bytes.subarray(3) : bytes;
66
+ return {
67
+ source: new TextDecoder("utf-8", { fatal: true }).decode(content),
68
+ bom,
69
+ };
70
+ }
71
+ function lineEnding(source) {
72
+ return source.includes("\r\n") ? "crlf" : "lf";
73
+ }
74
+ function lineRanges(source) {
75
+ const lines = [];
76
+ let start = 0;
77
+ while (start <= source.length) {
78
+ const lf = source.indexOf("\n", start);
79
+ const end = lf === -1 ? source.length : lf + 1;
80
+ const raw = source.slice(start, lf === -1 ? source.length : lf);
81
+ lines.push({ start, end, text: raw.replace(/\r$/, "") });
82
+ if (lf === -1)
83
+ break;
84
+ start = lf + 1;
85
+ }
86
+ return lines;
87
+ }
88
+ function locateFrontmatter(source) {
89
+ const lines = lineRanges(source);
90
+ if (lines[0]?.text.trimEnd() !== "---")
91
+ return { status: "none" };
92
+ const failures = [];
93
+ for (let index = 1; index < lines.length; index += 1) {
94
+ if (lines[index].text.trimEnd() !== "---")
95
+ continue;
96
+ const contentStart = lines[0].end;
97
+ const contentEnd = lines[index].start;
98
+ const document = parseDocument(source.slice(contentStart, contentEnd), {
99
+ keepSourceTokens: true,
100
+ logLevel: "silent",
101
+ });
102
+ if (document.errors.length > 0) {
103
+ failures.push(...document.errors.map((error) => error.message));
104
+ continue;
105
+ }
106
+ if (document.contents !== null && !isMap(document.contents)) {
107
+ failures.push("frontmatter must contain a mapping");
108
+ continue;
109
+ }
110
+ const map = (document.contents ?? document.createNode({}));
111
+ if (!isMap(map))
112
+ continue;
113
+ return {
114
+ status: "valid",
115
+ value: {
116
+ contentStart,
117
+ contentEnd,
118
+ bodyStart: lines[index].end,
119
+ document,
120
+ map,
121
+ },
122
+ };
123
+ }
124
+ return {
125
+ status: "invalid",
126
+ detail: failures[0] ?? "frontmatter closing delimiter is missing",
127
+ };
128
+ }
129
+ function scalarString(document, map, key) {
130
+ const pair = map.items.find((entry) => {
131
+ const node = entry.key;
132
+ return isScalar(node) && node.value === key;
133
+ });
134
+ if (pair === undefined || pair.value == null)
135
+ return undefined;
136
+ const node = isAlias(pair.value) ? pair.value.resolve(document) : pair.value;
137
+ if (!isScalar(node) || typeof node.value !== "string")
138
+ return null;
139
+ return node.value;
140
+ }
141
+ function parseBytes(bytes) {
142
+ const revision = documentRevision(bytes);
143
+ let decoded;
144
+ try {
145
+ decoded = decode(bytes);
146
+ }
147
+ catch (error) {
148
+ return {
149
+ status: "invalid",
150
+ kind: "encoding",
151
+ revision,
152
+ problem: problem("INVALID_ENCODING", error instanceof Error ? error.message : String(error)),
153
+ };
154
+ }
155
+ const frontmatter = locateFrontmatter(decoded.source);
156
+ if (frontmatter.status === "invalid") {
157
+ return {
158
+ status: "invalid",
159
+ kind: "frontmatter",
160
+ revision,
161
+ source: decoded.source,
162
+ problem: problem("INVALID_FRONTMATTER", frontmatter.detail),
163
+ };
164
+ }
165
+ const values = { name: "", description: "", argumentHint: "" };
166
+ if (frontmatter.status === "valid") {
167
+ const name = scalarString(frontmatter.value.document, frontmatter.value.map, "name");
168
+ const description = scalarString(frontmatter.value.document, frontmatter.value.map, "description");
169
+ const argumentHint = scalarString(frontmatter.value.document, frontmatter.value.map, "argument-hint");
170
+ if (name === null || description === null || argumentHint === null) {
171
+ return {
172
+ status: "invalid",
173
+ kind: "frontmatter",
174
+ revision,
175
+ source: decoded.source,
176
+ problem: problem("INVALID_FRONTMATTER", "owned frontmatter fields must be strings"),
177
+ };
178
+ }
179
+ values.name = name ?? "";
180
+ values.description = description ?? "";
181
+ values.argumentHint = argumentHint ?? "";
182
+ }
183
+ const body = frontmatter.status === "valid"
184
+ ? decoded.source.slice(frontmatter.value.bodyStart)
185
+ : decoded.source;
186
+ const draft = { frontmatter: values, body };
187
+ const view = {
188
+ origin: frontmatter.status === "none" && body.trim().length === 0 ? "new" : "existing",
189
+ revision,
190
+ format: { bom: decoded.bom, lineEnding: lineEnding(decoded.source) },
191
+ draft,
192
+ guidedSections: skillGuidedSections(body),
193
+ };
194
+ return {
195
+ status: "valid",
196
+ value: {
197
+ bytes,
198
+ source: decoded.source,
199
+ bom: decoded.bom,
200
+ lineEnding: view.format.lineEnding,
201
+ ...(frontmatter.status === "valid" ? { frontmatter: frontmatter.value } : {}),
202
+ draft,
203
+ view,
204
+ },
205
+ };
206
+ }
207
+ function exactSkillPath(pluginDirectory, skillDirectory) {
208
+ const authorization = authorizeExistingDirectory(pluginDirectory);
209
+ return resolveAuthorizedPath(authorization, `${skillDirectory}/${SKILL_DOCUMENT_FILENAME}`);
210
+ }
211
+ function unavailableFrom(error) {
212
+ const unsafe = error instanceof AuthorizedPathError;
213
+ return {
214
+ status: "unavailable",
215
+ problem: problem(unsafe ? "SKILL_UNSAFE" : "SKILL_UNAVAILABLE", error instanceof Error ? error.message : String(error)),
216
+ };
217
+ }
218
+ export function readSkillDocument(request, dependencies = {}) {
219
+ let path;
220
+ try {
221
+ path = exactSkillPath(request.pluginDirectory, request.skillDirectory);
222
+ if (!existsSync(path)) {
223
+ return { status: "unavailable", problem: problem("SKILL_MISSING") };
224
+ }
225
+ const stat = lstatSync(path);
226
+ if (!stat.isFile() || stat.isSymbolicLink() || stat.size > MAX_SKILL_DOCUMENT_BYTES) {
227
+ throw new Error("SKILL.md 不是受支持大小的普通文件");
228
+ }
229
+ const bytes = (dependencies.readSource ?? readFileSync)(path);
230
+ if (bytes.byteLength > MAX_SKILL_DOCUMENT_BYTES) {
231
+ throw new Error("SKILL.md 超过安全大小上限");
232
+ }
233
+ const parsed = parseBytes(bytes);
234
+ if (parsed.status === "valid") {
235
+ return { status: "loaded", sourceBytes: Buffer.from(bytes), document: parsed.value.view };
236
+ }
237
+ const previewBytes = bytes.subarray(0, RAW_PREVIEW_BYTES);
238
+ return {
239
+ status: "uninterpretable",
240
+ kind: parsed.kind,
241
+ revision: parsed.revision,
242
+ problem: parsed.problem,
243
+ preview: parsed.kind === "encoding"
244
+ ? { kind: "hex", content: previewBytes.toString("hex"), truncated: bytes.length > previewBytes.length }
245
+ : { kind: "text", content: (parsed.source ?? "").slice(0, RAW_PREVIEW_BYTES), truncated: (parsed.source?.length ?? 0) > RAW_PREVIEW_BYTES },
246
+ };
247
+ }
248
+ catch (error) {
249
+ return unavailableFrom(error);
250
+ }
251
+ }
252
+ function pairFor(map, key) {
253
+ return map.items.find((pair) => isScalar(pair.key) && pair.key.value === key);
254
+ }
255
+ function yamlScalar(value) {
256
+ const document = new Document(value);
257
+ return document.toString({ lineWidth: 0 }).trimEnd();
258
+ }
259
+ function patchFrontmatter(source, slice, original, next, eol) {
260
+ const fields = [
261
+ ["name", original.name, next.name],
262
+ ["description", original.description, next.description],
263
+ ["argument-hint", original.argumentHint, next.argumentHint],
264
+ ];
265
+ if (slice === undefined) {
266
+ if (fields.every(([, , value]) => value.length === 0))
267
+ return source;
268
+ const header = fields
269
+ .filter(([, , value]) => value.length > 0)
270
+ .map(([key, , value]) => `${key}: ${yamlScalar(value)}`)
271
+ .join(eol);
272
+ return `---${eol}${header}${eol}---${eol}${source}`;
273
+ }
274
+ const block = source.slice(slice.contentStart, slice.contentEnd);
275
+ const replacements = [];
276
+ const additions = [];
277
+ for (const [key, before, after] of fields) {
278
+ if (before === after)
279
+ continue;
280
+ const pair = pairFor(slice.map, key);
281
+ const node = pair?.value;
282
+ if (node?.range != null) {
283
+ replacements.push({ start: node.range[0], end: node.range[1], value: yamlScalar(after) });
284
+ }
285
+ else if (after.length > 0) {
286
+ additions.push(`${key}: ${yamlScalar(after)}`);
287
+ }
288
+ }
289
+ let patched = block;
290
+ for (const replacement of replacements.sort((left, right) => right.start - left.start)) {
291
+ patched = `${patched.slice(0, replacement.start)}${replacement.value}${patched.slice(replacement.end)}`;
292
+ }
293
+ if (additions.length > 0) {
294
+ if (patched.length > 0 && !patched.endsWith("\n"))
295
+ patched += eol;
296
+ patched += `${additions.join(eol)}${eol}`;
297
+ }
298
+ return `${source.slice(0, slice.contentStart)}${patched}${source.slice(slice.contentEnd)}`;
299
+ }
300
+ function isDraft(value) {
301
+ return (typeof value.body === "string" &&
302
+ value.body.length <= MAX_SKILL_DOCUMENT_BYTES &&
303
+ typeof value.frontmatter?.name === "string" &&
304
+ typeof value.frontmatter.description === "string" &&
305
+ typeof value.frontmatter.argumentHint === "string" &&
306
+ value.frontmatter.name.length + value.frontmatter.description.length + value.frontmatter.argumentHint.length <= MAX_SKILL_DOCUMENT_BYTES);
307
+ }
308
+ export function buildSkillDocumentBytes(sourceBytes, draft) {
309
+ if (!isDraft(draft)) {
310
+ return { status: "invalid-input", problem: problem("INVALID_FRONTMATTER", "draft exceeds safe bounds") };
311
+ }
312
+ const parsed = parseBytes(Buffer.from(sourceBytes));
313
+ if (parsed.status === "invalid") {
314
+ return { status: "invalid-source", problem: parsed.problem };
315
+ }
316
+ if (parsed.value.draft.body === draft.body &&
317
+ parsed.value.draft.frontmatter.name === draft.frontmatter.name &&
318
+ parsed.value.draft.frontmatter.description === draft.frontmatter.description &&
319
+ parsed.value.draft.frontmatter.argumentHint === draft.frontmatter.argumentHint) {
320
+ return { status: "built", bytes: Buffer.from(sourceBytes) };
321
+ }
322
+ const eol = parsed.value.lineEnding === "crlf" ? "\r\n" : "\n";
323
+ const frontPatched = patchFrontmatter(parsed.value.source, parsed.value.frontmatter, parsed.value.draft.frontmatter, draft.frontmatter, eol);
324
+ const located = locateFrontmatter(frontPatched);
325
+ const bodyStart = located.status === "valid" ? located.value.bodyStart : 0;
326
+ const nextSource = `${frontPatched.slice(0, bodyStart)}${draft.body}`;
327
+ const encoded = Buffer.from(nextSource, "utf8");
328
+ const bytes = parsed.value.bom ? Buffer.concat([UTF8_BOM, encoded]) : encoded;
329
+ if (bytes.byteLength > MAX_SKILL_DOCUMENT_BYTES) {
330
+ return { status: "invalid-input", problem: problem("INVALID_FRONTMATTER", "document exceeds safe bounds") };
331
+ }
332
+ return { status: "built", bytes };
333
+ }
334
+ export function saveSkillDocument(request, dependencies = {}) {
335
+ const loaded = readSkillDocument(request, dependencies);
336
+ if (loaded.status === "unavailable") {
337
+ return { status: "invalid-source", problem: loaded.problem, diskChanged: false, changedPaths: [], cleanupComplete: true };
338
+ }
339
+ if (loaded.status === "uninterpretable") {
340
+ return { status: "invalid-source", problem: loaded.problem, diskChanged: false, changedPaths: [], cleanupComplete: true };
341
+ }
342
+ const built = buildSkillDocumentBytes(loaded.sourceBytes, request.draft);
343
+ if (built.status !== "built") {
344
+ return { status: built.status, problem: built.problem, diskChanged: false, changedPaths: [], cleanupComplete: true };
345
+ }
346
+ let authorization;
347
+ try {
348
+ authorization = authorizeExistingDirectory(request.pluginDirectory);
349
+ const target = resolveAuthorizedPath(authorization, `${request.skillDirectory}/${SKILL_DOCUMENT_FILENAME}`);
350
+ const relativePath = relative(authorization.canonicalPath, target).split(sep).join("/");
351
+ const committed = (dependencies.commit ?? commitAuthorizedDocument)({
352
+ directory: authorization.canonicalPath,
353
+ relativePath,
354
+ expectedRevision: request.expectedRevision,
355
+ nextBytes: built.bytes,
356
+ }, dependencies.commitDependencies);
357
+ if (committed.status === "committed")
358
+ return { ...committed, status: "saved" };
359
+ if (committed.status === "verified")
360
+ return { ...committed, status: "verified" };
361
+ return committed;
362
+ }
363
+ catch (error) {
364
+ const failure = unavailableFrom(error);
365
+ return { status: "invalid-source", problem: failure.problem, diskChanged: false, changedPaths: [], cleanupComplete: true };
366
+ }
367
+ }
368
+ //# sourceMappingURL=skill-document.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-document.js","sourceRoot":"","sources":["../../src/application/skill-document.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ export interface CreateWorkspaceRequest {
2
+ readonly directory: string;
3
+ readonly name: string;
4
+ readonly organization: string;
5
+ readonly includePlugkit: boolean;
6
+ }
7
+ export type WorkspaceCreationChangeAction = 'create' | 'update' | 'preserve';
8
+ export interface WorkspaceCreationChange {
9
+ readonly relativePath: string;
10
+ readonly action: WorkspaceCreationChangeAction;
11
+ readonly summary: string;
12
+ }
13
+ export interface WorkspaceCreationConflict {
14
+ readonly code: 'MARKETPLACE_EXISTS' | 'INVALID_PACKAGE_JSON' | 'UNSAFE_PATH' | 'PATH_UNAVAILABLE';
15
+ readonly title: string;
16
+ readonly message: string;
17
+ readonly relativePath?: string;
18
+ }
19
+ export interface WorkspaceCreationPlan {
20
+ readonly status: 'ready' | 'blocked';
21
+ readonly targetPath: string;
22
+ readonly marketplaceName: string;
23
+ readonly organization: string;
24
+ readonly includePlugkit: boolean;
25
+ readonly changes: readonly WorkspaceCreationChange[];
26
+ readonly conflicts: readonly WorkspaceCreationConflict[];
27
+ readonly preservationNote: string;
28
+ /**
29
+ * Opaque comparison token. Callers must not inspect or derive behavior from it.
30
+ */
31
+ readonly fingerprint: string;
32
+ }
33
+ export type ExecuteWorkspaceCreationResult = {
34
+ readonly status: 'created';
35
+ readonly targetPath: string;
36
+ readonly written: readonly string[];
37
+ readonly preserved: readonly string[];
38
+ } | {
39
+ readonly status: 'blocked';
40
+ readonly conflicts: readonly WorkspaceCreationConflict[];
41
+ } | {
42
+ readonly status: 'stale';
43
+ readonly message: string;
44
+ } | {
45
+ readonly status: 'failed';
46
+ readonly message: string;
47
+ readonly changedPaths: readonly string[];
48
+ readonly rollbackComplete: boolean;
49
+ };
50
+ export declare function isWorkspaceCreationPlan(value: unknown): value is WorkspaceCreationPlan;
@@ -0,0 +1,16 @@
1
+ export function isWorkspaceCreationPlan(value) {
2
+ if (value === null || typeof value !== 'object')
3
+ return false;
4
+ const plan = value;
5
+ return ((plan.status === 'ready' || plan.status === 'blocked') &&
6
+ typeof plan.targetPath === 'string' &&
7
+ typeof plan.marketplaceName === 'string' &&
8
+ typeof plan.organization === 'string' &&
9
+ typeof plan.includePlugkit === 'boolean' &&
10
+ Array.isArray(plan.changes) &&
11
+ Array.isArray(plan.conflicts) &&
12
+ typeof plan.preservationNote === 'string' &&
13
+ typeof plan.fingerprint === 'string' &&
14
+ plan.fingerprint.length > 0);
15
+ }
16
+ //# sourceMappingURL=workspace-create-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-create-contract.js","sourceRoot":"","sources":["../../src/application/workspace-create-contract.ts"],"names":[],"mappings":"AA8DA,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,OAAO,CACL,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QACtD,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QACnC,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ;QACxC,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;QACrC,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS;QACxC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAC3B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7B,OAAO,IAAI,CAAC,gBAAgB,KAAK,QAAQ;QACzC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACpC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAC5B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,8 @@
1
+ import type { CreateWorkspaceRequest, ExecuteWorkspaceCreationResult, WorkspaceCreationPlan } from './workspace-create-contract.js';
2
+ export interface WorkspaceCreationDependencies {
3
+ readonly beforeApplyChange?: (relativePath: string, appliedCount: number) => void;
4
+ readonly cleanupStaging?: (stagingRoot: string) => void;
5
+ }
6
+ export declare function planWorkspaceCreation(request: CreateWorkspaceRequest): WorkspaceCreationPlan;
7
+ export declare function executeWorkspaceCreation(request: CreateWorkspaceRequest, expectedFingerprint: string, dependencies?: WorkspaceCreationDependencies): ExecuteWorkspaceCreationResult;
8
+ export declare function normalizeWorkspaceCreationRequest(directory: string, name: string | undefined, organization: string | undefined, includePlugkit: boolean): CreateWorkspaceRequest;