release-skill 0.9.34 → 0.9.36

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 (53) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codebuddy-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +2 -2
  4. package/.cursor-plugin/plugin.json +1 -1
  5. package/.kimi-plugin/plugin.json +1 -1
  6. package/.qoder-plugin/plugin.json +1 -1
  7. package/CHANGELOG.md +41 -0
  8. package/INSTALL.md +2 -2
  9. package/INSTALL.zh-CN.md +2 -2
  10. package/README.md +10 -17
  11. package/README.zh-CN.md +10 -17
  12. package/adapters/claude/.claude-plugin/plugin.json +1 -1
  13. package/adapters/claude/bin/release-skill.bundle.mjs +190 -59
  14. package/adapters/claude/schemas/.render-manifest.json +6 -2
  15. package/adapters/claude/skills/release-finish/SKILL.md +5 -1
  16. package/adapters/claude/skills/release-help/SKILL.md +1 -1
  17. package/adapters/codex/.codex-plugin/plugin.json +2 -2
  18. package/adapters/codex/bin/release-skill.bundle.mjs +190 -59
  19. package/adapters/codex/schemas/.render-manifest.json +6 -2
  20. package/adapters/codex/skills/release-finish/SKILL.md +5 -1
  21. package/adapters/codex/skills/release-help/SKILL.md +1 -1
  22. package/adapters/cursor/.cursor-plugin/plugin.json +1 -1
  23. package/adapters/cursor/bin/release-skill.bundle.mjs +190 -59
  24. package/adapters/cursor/schemas/.render-manifest.json +6 -2
  25. package/adapters/cursor/skills/release-finish/SKILL.md +5 -1
  26. package/adapters/cursor/skills/release-help/SKILL.md +1 -1
  27. package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
  28. package/adapters/kimi/bin/release-skill.bundle.mjs +190 -59
  29. package/adapters/kimi/schemas/.render-manifest.json +6 -2
  30. package/adapters/kimi/skills/release-finish/SKILL.md +5 -1
  31. package/adapters/kimi/skills/release-help/SKILL.md +1 -1
  32. package/adapters/qoder/.qoder-plugin/plugin.json +1 -1
  33. package/adapters/qoder/bin/release-skill.bundle.mjs +190 -59
  34. package/adapters/qoder/schemas/.render-manifest.json +6 -2
  35. package/adapters/qoder/skills/release-finish/SKILL.md +5 -1
  36. package/adapters/qoder/skills/release-help/SKILL.md +1 -1
  37. package/adapters/workbuddy/.codebuddy-plugin/plugin.json +1 -1
  38. package/adapters/workbuddy/bin/release-skill.bundle.mjs +190 -59
  39. package/adapters/workbuddy/schemas/.render-manifest.json +6 -2
  40. package/adapters/workbuddy/skills/release-finish/SKILL.md +5 -1
  41. package/adapters/workbuddy/skills/release-help/SKILL.md +1 -1
  42. package/bin/release-skill.bundle.mjs +190 -59
  43. package/package.json +1 -1
  44. package/platform-manifest.json +4 -4
  45. package/references/.render-manifest.json +2 -2
  46. package/references/02-project-config.md +5 -1
  47. package/schemas/.render-manifest.json +6 -2
  48. package/skills/release-finish/SKILL.md +5 -1
  49. package/skills/release-help/SKILL.md +1 -1
  50. package/skills-src/release-finish/SKILL.md +5 -1
  51. package/skills-src/release-help/SKILL.md +1 -1
  52. package/src/adapters/plugin-marketplace.mjs +152 -43
  53. package/src/commands/post-release-local.mjs +71 -34
@@ -9,9 +9,9 @@ const __bundlePkgRoot = __bundleResolve(__bundleDirname(__bundleFileURLToPath(im
9
9
  // Provide a real require() for CJS packages bundled into ESM (e.g. yaml, ajv).
10
10
  const __bundleRealRequire = __bundleCreateRequire(import.meta.url);
11
11
  // Package identity injected at build time — closure-independent --version probe.
12
- const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.34"});
12
+ const __bundlePkg = Object.freeze({"name":"release-skill","version":"0.9.36"});
13
13
  // Build-time source digest for the BUNDLE_STALE freshness gate (see above).
14
- const __bundleSourceDigest = "218550cf2d3009ab588c7a6a20d1898281fec7adf2a1e694affc7eda2642a277";
14
+ const __bundleSourceDigest = "bc9386087a5bffe2f92c12f687ec75582a9e853164020e99618a4bdf5cd13a68";
15
15
 
16
16
  var __create = Object.create;
17
17
  var __defProp = Object.defineProperty;
@@ -113912,6 +113912,66 @@ function normalizeCodeBuddySkillsRel(skillsRaw) {
113912
113912
  }
113913
113913
  return rel;
113914
113914
  }
113915
+ async function resolveCodexEntrySkillFile(pluginRoot, entrySkill, pluginName) {
113916
+ const { normalizeGenericSkillsRel: normalizeGenericSkillsRel2 } = await init_surface_host_bindings().then(() => surface_host_bindings_exports);
113917
+ if (!entrySkill || typeof entrySkill !== "string" || !SAFE_ID_RE.test(entrySkill)) {
113918
+ throw new Error(`unsafe entrySkill: "${entrySkill}"`);
113919
+ }
113920
+ const platform = getPlatform("codex");
113921
+ const manifestPath = await resolveContained(pluginRoot, platform.manifestPaths.plugin);
113922
+ let manifest;
113923
+ try {
113924
+ manifest = JSON.parse(await readFile26(manifestPath, "utf8"));
113925
+ } catch (err) {
113926
+ throw new Error(`Codex plugin manifest cannot be read: ${err.message}`);
113927
+ }
113928
+ if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
113929
+ throw new Error("Codex plugin manifest must be an object");
113930
+ }
113931
+ const skillsRel = Object.hasOwn(manifest, "skills") ? normalizeGenericSkillsRel2(manifest.skills) : "skills";
113932
+ const skillsRoot = await resolveContained(pluginRoot, skillsRel);
113933
+ let skillsRootStat;
113934
+ try {
113935
+ skillsRootStat = await lstat37(skillsRoot);
113936
+ } catch {
113937
+ throw new Error(`Codex manifest skills root does not exist: ${manifest.skills ?? skillsRel}`);
113938
+ }
113939
+ if (skillsRootStat.isSymbolicLink() || !skillsRootStat.isDirectory()) {
113940
+ throw new Error(`Codex manifest skills root must be a real directory: ${manifest.skills ?? skillsRel}`);
113941
+ }
113942
+ const findCandidate = /* @__PURE__ */ __name(async (skillDirName) => {
113943
+ const skillDir = await resolveContained(pluginRoot, `${skillsRel}/${skillDirName}`);
113944
+ let skillDirStat;
113945
+ try {
113946
+ skillDirStat = await lstat37(skillDir);
113947
+ } catch (err) {
113948
+ if (err?.code === "ENOENT") return null;
113949
+ throw err;
113950
+ }
113951
+ if (skillDirStat.isSymbolicLink() || !skillDirStat.isDirectory()) {
113952
+ throw new Error(`Codex entry skill directory must be a real directory: ${skillsRel}/${skillDirName}`);
113953
+ }
113954
+ const skillFile = await resolveContained(pluginRoot, `${skillsRel}/${skillDirName}/SKILL.md`);
113955
+ let skillStat;
113956
+ try {
113957
+ skillStat = await lstat37(skillFile);
113958
+ } catch (err) {
113959
+ if (err?.code === "ENOENT") return null;
113960
+ throw err;
113961
+ }
113962
+ if (skillStat.isSymbolicLink() || !skillStat.isFile()) {
113963
+ throw new Error(`Codex entry skill must be a regular non-symlink file: ${skillsRel}/${skillDirName}/SKILL.md`);
113964
+ }
113965
+ return skillFile;
113966
+ }, "findCandidate");
113967
+ const shortNameEntry = await findCandidate(entrySkill);
113968
+ if (shortNameEntry) return shortNameEntry;
113969
+ if (pluginName && SAFE_ID_RE.test(pluginName)) {
113970
+ const prefixedEntry = await findCandidate(`${pluginName}-${entrySkill}`);
113971
+ if (prefixedEntry) return prefixedEntry;
113972
+ }
113973
+ throw new Error(`Codex entry skill not found: ${skillsRel}/${entrySkill}/SKILL.md`);
113974
+ }
113915
113975
  async function resolveCodeBuddyEntrySkillFile(pluginRootReal, manifest, entrySkill) {
113916
113976
  if (!entrySkill || typeof entrySkill !== "string" || !SAFE_ID_RE.test(entrySkill)) {
113917
113977
  throw new Error(`unsafe entrySkill: "${entrySkill}"`);
@@ -115067,6 +115127,17 @@ function createPluginMarketplaceAdapter(deps = {}) {
115067
115127
  error: `entry skill not resolvable in snapshot: ${entryErr.message}`
115068
115128
  });
115069
115129
  }
115130
+ } else if (consumer === "codex") {
115131
+ const pluginRootForSkill = pluginRootForEntrySkill || snapshotDirReal;
115132
+ try {
115133
+ await resolveCodexEntrySkillFile(pluginRootForSkill, action.entrySkill, action.plugin);
115134
+ } catch (entryErr) {
115135
+ return createResult({
115136
+ actionType,
115137
+ status: ActionStatus.PREFLIGHT_FAILED,
115138
+ error: `entry skill not resolvable in snapshot: ${entryErr.message}`
115139
+ });
115140
+ }
115070
115141
  } else {
115071
115142
  const pluginRootForSkill = pluginRootForEntrySkill || snapshotDirReal;
115072
115143
  let entrySkillFile = resolve22(pluginRootForSkill, "skills", action.entrySkill, "SKILL.md");
@@ -116181,42 +116252,59 @@ function createPluginMarketplaceAdapter(deps = {}) {
116181
116252
  }
116182
116253
  });
116183
116254
  }
116184
- let entrySkillPath = resolve22(installPath, "skills", action.entrySkill, "SKILL.md");
116185
- let entrySkillFound = false;
116186
- try {
116187
- const skillStat = await lstat37(entrySkillPath);
116188
- if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
116189
- entrySkillFound = true;
116255
+ if (consumer === "codex") {
116256
+ try {
116257
+ await resolveCodexEntrySkillFile(installPath, action.entrySkill, action.plugin);
116258
+ } catch (entryErr) {
116259
+ return createResult({
116260
+ actionType,
116261
+ status: ActionStatus.OBSERVED,
116262
+ observation: {
116263
+ installed: true,
116264
+ installPath,
116265
+ entrySkillFound: false,
116266
+ error: `entry skill not resolvable in installed plugin: ${entryErr.message}`
116267
+ }
116268
+ });
116190
116269
  }
116191
- } catch {
116192
- }
116193
- if (!entrySkillFound && action.plugin) {
116194
- const prefixedPath = resolve22(
116195
- installPath,
116196
- "skills",
116197
- `${action.plugin}-${action.entrySkill}`,
116198
- "SKILL.md"
116199
- );
116270
+ } else {
116271
+ let entrySkillPath = resolve22(installPath, "skills", action.entrySkill, "SKILL.md");
116272
+ let entrySkillFound = false;
116200
116273
  try {
116201
- const skillStat = await lstat37(prefixedPath);
116274
+ const skillStat = await lstat37(entrySkillPath);
116202
116275
  if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
116203
- entrySkillPath = prefixedPath;
116204
116276
  entrySkillFound = true;
116205
116277
  }
116206
116278
  } catch {
116207
116279
  }
116208
- }
116209
- if (!entrySkillFound) {
116210
- return createResult({
116211
- actionType,
116212
- status: ActionStatus.OBSERVED,
116213
- observation: {
116214
- installed: true,
116280
+ if (!entrySkillFound && action.plugin) {
116281
+ const prefixedPath = resolve22(
116215
116282
  installPath,
116216
- entrySkillFound: false,
116217
- error: `entry skill not found: skills/${action.entrySkill}/SKILL.md`
116283
+ "skills",
116284
+ `${action.plugin}-${action.entrySkill}`,
116285
+ "SKILL.md"
116286
+ );
116287
+ try {
116288
+ const skillStat = await lstat37(prefixedPath);
116289
+ if (skillStat.isFile() && !skillStat.isSymbolicLink()) {
116290
+ entrySkillPath = prefixedPath;
116291
+ entrySkillFound = true;
116292
+ }
116293
+ } catch {
116218
116294
  }
116219
- });
116295
+ }
116296
+ if (!entrySkillFound) {
116297
+ return createResult({
116298
+ actionType,
116299
+ status: ActionStatus.OBSERVED,
116300
+ observation: {
116301
+ installed: true,
116302
+ installPath,
116303
+ entrySkillFound: false,
116304
+ error: `entry skill not found: skills/${action.entrySkill}/SKILL.md`
116305
+ }
116306
+ });
116307
+ }
116220
116308
  }
116221
116309
  let manifestDigest;
116222
116310
  let manifestError = null;
@@ -116418,6 +116506,7 @@ var init_plugin_marketplace = __esm({
116418
116506
  __name(normalizeKimiSkillsRel, "normalizeKimiSkillsRel");
116419
116507
  __name(resolveKimiEntrySkillFile, "resolveKimiEntrySkillFile");
116420
116508
  __name(normalizeCodeBuddySkillsRel, "normalizeCodeBuddySkillsRel");
116509
+ __name(resolveCodexEntrySkillFile, "resolveCodexEntrySkillFile");
116421
116510
  __name(resolveCodeBuddyEntrySkillFile, "resolveCodeBuddyEntrySkillFile");
116422
116511
  SUPPORTED_TYPES = [
116423
116512
  ActionType.PLUGIN_MANIFEST_VALIDATE,
@@ -116458,6 +116547,14 @@ var init_plugin_marketplace = __esm({
116458
116547
  });
116459
116548
 
116460
116549
  // src/core/surface-host-bindings.mjs
116550
+ var surface_host_bindings_exports = {};
116551
+ __export(surface_host_bindings_exports, {
116552
+ deriveSurfaceHostBinding: () => deriveSurfaceHostBinding,
116553
+ groupSurfaceHostBindings: () => groupSurfaceHostBindings,
116554
+ normalizeGenericSkillsRel: () => normalizeGenericSkillsRel,
116555
+ normalizeSurfacePath: () => normalizeSurfacePath,
116556
+ pluginRootFromManifestRelativePath: () => pluginRootFromManifestRelativePath
116557
+ });
116461
116558
  import { dirname as dirname10, isAbsolute as isAbsolute18, join as join19, normalize as normalize3, resolve as resolve23, sep as sep9 } from "node:path";
116462
116559
  import { lstat as lstat38 } from "node:fs/promises";
116463
116560
  function normalizeSurfacePath(rawPath) {
@@ -139649,15 +139746,28 @@ async function observeQoderPlugin(target, command2, env, run6) {
139649
139746
  found
139650
139747
  };
139651
139748
  }
139652
- async function readQoderManifest(root, label) {
139653
- const manifest = parseJson2(
139654
- await readFileContained(root, ".qoder-plugin/plugin.json", { encoding: "utf8" }),
139655
- label
139656
- );
139657
- if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
139658
- throw new Error(`${label} did not return an object`);
139749
+ async function readQoderManifest(root, label, target) {
139750
+ const candidates = [];
139751
+ for (const manifestPath of [".qoder-plugin/plugin.json", ".claude-plugin/plugin.json"]) {
139752
+ let text;
139753
+ try {
139754
+ text = await readFileContained(root, manifestPath, { encoding: "utf8" });
139755
+ } catch (error) {
139756
+ if (error?.code === "SFC2004" && error?.details?.kind === "missing-resource") continue;
139757
+ throw error;
139758
+ }
139759
+ const manifest = parseJson2(text, `${label} (${manifestPath})`);
139760
+ if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
139761
+ throw new Error(`${label} (${manifestPath}) did not return an object`);
139762
+ }
139763
+ await assertQoderPluginManifest(target, manifest, `${label} (${manifestPath})`, root);
139764
+ candidates.push({ manifestPath, manifest });
139659
139765
  }
139660
- return manifest;
139766
+ if (candidates.length === 0) throw new Error(`${label} has no native or compatible plugin manifest`);
139767
+ if (candidates.length === 2 && ["name", "version"].some((field) => candidates[0].manifest[field] !== candidates[1].manifest[field])) {
139768
+ throw new Error(`${label} does not match the frozen Qoder plugin identity and projection path: conflicting native and compatible manifests`);
139769
+ }
139770
+ return candidates[0];
139661
139771
  }
139662
139772
  async function assertQoderPluginManifest(target, manifest, label, pluginRoot, frozenSkills) {
139663
139773
  if (manifest.name !== target.plugin || manifest.version !== target.version || typeof manifest.skills !== "string" || manifest.skills.length === 0 || frozenSkills !== void 0 && manifest.skills !== frozenSkills) {
@@ -139675,35 +139785,56 @@ async function assertFrozenQoderManifest(target, root) {
139675
139785
  snapshotPath: target.snapshotPath,
139676
139786
  expectedDigest: target.manifestDigest
139677
139787
  });
139678
- const manifest = await readQoderManifest(snapshotRoot, "frozen Qoder plugin manifest");
139679
- return assertQoderPluginManifest(target, manifest, "frozen Qoder plugin manifest", snapshotRoot);
139788
+ const { manifestPath, manifest } = await readQoderManifest(snapshotRoot, "frozen Qoder plugin manifest", target);
139789
+ const skills = await assertQoderPluginManifest(target, manifest, "frozen Qoder plugin manifest", snapshotRoot);
139790
+ return { manifestPath, skills };
139680
139791
  }
139681
139792
  async function assertQoderHubEntry(target, marketplaceRoot) {
139682
- const marketplace = parseJson2(
139683
- await readFileContained(marketplaceRoot, "marketplace.json", { encoding: "utf8" }),
139684
- "Qoder Hub marketplace manifest"
139685
- );
139686
- if (marketplace?.name !== target.marketplace || !Array.isArray(marketplace.plugins)) {
139687
- throw new Error("Qoder Hub marketplace manifest does not match the frozen marketplace");
139688
- }
139689
- const matches = marketplace.plugins.filter((entry) => entry?.name === target.plugin);
139690
- if (matches.length !== 1) {
139691
- throw new Error(`Qoder Hub marketplace manifest must contain exactly one ${target.plugin} entry`);
139692
- }
139693
- const source = matches[0]?.source;
139694
- if (source?.source !== "url" || normalizeHubGitSource(source.url, target.hub.githubHost) !== target.pluginRepo || source.sha !== target.pluginCommit) {
139695
- throw new Error("Qoder Hub entry does not match the frozen public source identity");
139793
+ let found = false;
139794
+ for (const indexPath of ["marketplace.json", ".claude-plugin/marketplace.json"]) {
139795
+ let text;
139796
+ try {
139797
+ text = await readFileContained(marketplaceRoot, indexPath, { encoding: "utf8" });
139798
+ } catch (error) {
139799
+ if (error?.code === "SFC2004" && error?.details?.kind === "missing-resource") continue;
139800
+ throw error;
139801
+ }
139802
+ found = true;
139803
+ const marketplace = parseJson2(text, `Qoder Hub marketplace manifest (${indexPath})`);
139804
+ if (!marketplace || typeof marketplace !== "object" || Array.isArray(marketplace) || marketplace.name !== target.marketplace || !Array.isArray(marketplace.plugins)) {
139805
+ throw new Error("Qoder Hub marketplace manifest does not match the frozen marketplace");
139806
+ }
139807
+ if (indexPath === ".claude-plugin/marketplace.json") {
139808
+ if (target.hub.githubHost !== "github.com" || typeof target.frozenTag !== "string" || target.frozenTag.length === 0) {
139809
+ throw new Error("Qoder compatible Hub entry requires a frozen GitHub tag identity");
139810
+ }
139811
+ await assertHubHostEntry({ ...target, host: "claude", pluginTag: target.frozenTag, githubHost: target.hub.githubHost }, marketplaceRoot);
139812
+ continue;
139813
+ }
139814
+ const matches = marketplace.plugins.filter((entry2) => entry2?.name === target.plugin);
139815
+ if (matches.length !== 1) {
139816
+ throw new Error(`Qoder Hub marketplace manifest must contain exactly one ${target.plugin} entry`);
139817
+ }
139818
+ const entry = matches[0];
139819
+ const source = entry.source;
139820
+ if (source?.source !== "url" || normalizeHubGitSource(source.url, target.hub.githubHost) !== target.pluginRepo || source.sha !== target.pluginCommit || entry.version !== void 0 && entry.version !== target.version || source.ref !== void 0 && (typeof target.frozenTag !== "string" || source.ref !== target.frozenTag)) {
139821
+ throw new Error("Qoder Hub entry does not match the frozen public source identity");
139822
+ }
139696
139823
  }
139824
+ if (!found) throw new Error("Qoder Hub has no native or compatible marketplace manifest");
139697
139825
  }
139698
139826
  async function verifyQoderInstalledPayload({
139699
139827
  target,
139700
139828
  root,
139701
139829
  installPath,
139702
- frozenSkills,
139830
+ frozenManifest,
139703
139831
  verifyInstalledPayload
139704
139832
  }) {
139705
- const manifest = await readQoderManifest(installPath, "installed Qoder plugin manifest");
139706
- await assertQoderPluginManifest(target, manifest, "installed Qoder plugin manifest", installPath, frozenSkills);
139833
+ const { manifestPath, manifest } = await readQoderManifest(installPath, "installed Qoder plugin manifest", target);
139834
+ if (manifestPath !== frozenManifest.manifestPath) {
139835
+ throw new Error("installed Qoder plugin manifest path differs from the frozen manifest selection");
139836
+ }
139837
+ await assertQoderPluginManifest(target, manifest, "installed Qoder plugin manifest", installPath, frozenManifest.skills);
139707
139838
  await verifyInstalledPayload({
139708
139839
  snapshotPath: target.snapshotPath,
139709
139840
  manifestDigest: target.manifestDigest,
@@ -139716,7 +139847,7 @@ async function runQoderUpdate(target, detected, run6, {
139716
139847
  verifyInstalledPayload
139717
139848
  }) {
139718
139849
  const env = hostEnvironment("qoder");
139719
- const frozenSkills = await assertFrozenQoderManifest(target, root);
139850
+ const frozenManifest = await assertFrozenQoderManifest(target, root);
139720
139851
  const marketplace = await observeQoderMarketplace(target, detected.command, env, run6);
139721
139852
  if (!marketplace.installed) {
139722
139853
  return {
@@ -139737,7 +139868,7 @@ async function runQoderUpdate(target, detected, run6, {
139737
139868
  target,
139738
139869
  root,
139739
139870
  installPath: before.installPath,
139740
- frozenSkills,
139871
+ frozenManifest,
139741
139872
  verifyInstalledPayload
139742
139873
  });
139743
139874
  return { status: "ALREADY_CURRENT", version: target.version };
@@ -139764,7 +139895,7 @@ async function runQoderUpdate(target, detected, run6, {
139764
139895
  target,
139765
139896
  root,
139766
139897
  installPath: after.installPath,
139767
- frozenSkills,
139898
+ frozenManifest,
139768
139899
  verifyInstalledPayload
139769
139900
  });
139770
139901
  return {
@@ -17,6 +17,10 @@
17
17
  "digest": "86c9cab024ebe9c7f8ec3358fcc12d05b8ed246ab59da2b0acc6a517f31274ea",
18
18
  "bytes": 2488
19
19
  },
20
+ "evidence-event-v2.schema.json": {
21
+ "digest": "693430e636afc85bf4a79e3f7bf3fb87254cbd62f2e3f35c35d6f84e5e8e0be1",
22
+ "bytes": 6058
23
+ },
20
24
  "evidence-event.schema.json": {
21
25
  "digest": "b7e14522a5aba818cab191545f23d2323be0e4c80566e9d3e4da576103a00490",
22
26
  "bytes": 2390
@@ -34,8 +38,8 @@
34
38
  "bytes": 57111
35
39
  },
36
40
  "release-run.schema.json": {
37
- "digest": "4a041b8f6488e7d61b7eb271ebdbc2e043731df41c4437783ef63e77f664c192",
38
- "bytes": 19002
41
+ "digest": "26c44ddf1ed42f266a2ddee7f6132cee94c59593e37f24359c9c48f12612ec22",
42
+ "bytes": 21874
39
43
  },
40
44
  "test-intake.schema.json": {
41
45
  "digest": "654e91ce518cb2b8aca84947d0c3bb8c4262ab047d86081e7e93dc07a9c6c739",
@@ -72,7 +72,11 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
72
72
  - Claude/Codex 的 Hub 目标只使用已经登记的同源市场。升级前先读取声明的 Hub 分支,并核对宿主专用索引中的插件仓库、标签、提交及存在的版本字段。刷新市场后再次核对实际目录和条目,再执行原有更新或重装命令。Claude 精确当前安装会离线核对真实载荷;Codex 列表不提供安装根时,仍须正式重装,从安装输出取得 `installedPath` 后核对载荷。旧安装动作继续使用冻结市场引用预检;远端不可达或引用不符时返回 `MANUAL_REQUIRED`。每个宿主单独保留结果,失败不会中断其他已选宿主。
73
73
  - Kimi 的精确当前安装会在返回 `ALREADY_CURRENT` 前核对真实载荷;发生安装或迁移时,只在操作完成后核对结果。配置根依次取显式 `kimiHome`、`KIMI_CODE_HOME`、用户主目录下的 `.kimi-code`,TUI 与安装后观察使用同一根。release-finish 当前只采用并验证 Kimi Code 的受控终端交互界面(TUI)路径,并把 TUI 工作目录固定为 `--root` 指定的当前发布项目。用户已确认冻结计划、显式选择更新且 `--hosts` 包含 `kimi` 时,流程读取完整的初始 `Trust this folder?` 对话框,要求其中只有一个正向项 `Trust this folder` 和一个选中项。正向项已经选中时不发送方向键,直接确认;已知拒绝项选中时,按它与正向项的相对位置移动一次,重新读取完整对话框并确认正向项已选中,然后才提交。插件命令发出后再次出现目录信任、界面或选中项未知、正向项缺失或重复、移动后无法确认、超时或提前退出时,该宿主失败并停止后续安装步骤。若后续 Kimi 版本出现新的可复现界面差异,先记录 Kimi 版本、可见选项、选中项及选项关系;这些事实足以唯一确认当前目录、正向信任项和选择结果时,在最近测试补回归与兼容并继续,目录身份或选项语义不明时仍停止并交回主会话。插件信任仍先清理 ANSI/OSC 控制序列和软换行,再分别核对冻结仓库与标签;只有选中 `Trust and install` 才提交并重新加载。包名、版本、发布标签、已安装修订号和受管安装根必须与冻结计划一致;`.git` 只提供附加诊断,不是通过条件。旧的本地路径安装会在同一 TUI 会话中先移除,再按发布标签安装。
74
74
  - CodeBuddy/WorkBuddy 只升级既有安装,不自动首装。CodeBuddy 仅探测全局 `codebuddy`/`cbc`,配置根固定为有效 `HOME` 下的 `.codebuddy`;WorkBuddy 仅在 macOS 探测应用内嵌 CLI,配置根固定为有效 `HOME` 下的 `.workbuddy`,两者不互作回退。Hub 目标先核对各自 `plugins/marketplaces/<hub>` 的远端和分支,再核对 `.codebuddy-plugin/marketplace.json` 条目。刷新市场后确认远端分支未漂移,才更新插件;最后核对列表中的版本、`gitCommitSha` 和 `plugins/cache/<hub>/<plugin>/<version>` 的完整载荷。旧 bundled-family 目标继续要求插件标签和市场分支均指向冻结提交。非 macOS 的 WorkBuddy 返回 `SKIPPED_UNSUPPORTED_PLATFORM`。
75
- - Qoder 先用 `qoder plugins marketplace list --json` 核对计划声明的 Hub 名称、仓库、分支和本机 checkout,再用 `qoder plugins list --json` 核对唯一插件条目的市场、`scope=user`、版本与 `installPath`。目标市场或插件未安装时返回 `MANUAL_REQUIRED`,不添加市场,也不执行首次安装。旧版已安装时,只运行 `qoder plugins marketplace update <name>` 和 `qoder plugins update <plugin@marketplace> --scope user`。市场刷新后、插件更新前,必须从 Hub 的 `marketplace.json` 核对目标条目的 `source.url` 和 `source.sha`;操作后从真实 `installPath` 核对 Qoder manifest、完整声明载荷和冻结来源。市场可能在检查与更新之间变化,事后身份不符时报告失败,不自动降级、卸载或覆盖。
75
+ - Qoder 首先通过 `qoder plugins marketplace list --json` 验证目标 Hub 的名称、仓库地址、分支信息及本机 checkout 状态,随后使用 `qoder plugins list --json` 核对唯一插件条目的市场归属、`scope=user`、版本号与 `installPath`。若目标市场或插件未安装,返回 `MANUAL_REQUIRED`,禁止自动添加市场或执行首次安装。对于旧版已安装情况,仅执行 `qoder plugins marketplace update <name>` 与 `qoder plugins update <plugin@marketplace> --scope user`。在市场刷新后、插件更新前,必须完成以下来源核验。在已核对的市场安装根内,分别读取 `marketplace.json` 的 `url` 来源与 `.claude-plugin/marketplace.json` 的 `github` 来源;至少一个存在,且所有存在候选都须有效并绑定同一冻结目标。根目录来源核对 `source.url/source.sha`;兼容来源沿现有 Claude 断言核对仓库、冻结标签、提交和版本。任一损坏或冲突均拒绝,不猜测优先级。
76
+
77
+ 冻结快照与真实 `installPath` 均需比对 `.qoder-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 两个候选清单。仅当原生清单缺失时,方可启用兼容清单;原生清单存在但无效时不得回退。存在的清单均须可解析为有效对象,且以原生清单为优先。每个已存在候选(包括未选候选)都须核对目标 `name/version`;其 `skills` 必须为非空字符串,经 `Foundation 0.25.0` 的 `resolveContained` 解析为根内真实目录。跨候选只比较 `name/version`,允许各自合法 `skills` 不同;原生正常不能遮蔽兼容无效。安装侧选择的相对清单路径及 `skills` 必须与冻结侧选择一致。安装侧额外出现的损坏或冲突清单不得忽略;允许宿主附加文件的 `external-marketplace-v1` 载荷完整比较,不可替代对清单的独立核验。
78
+
79
+ 冻结快照摘要须在宿主写入前完成复验,安装后仍需复验完整声明载荷与冻结来源;即使版本已为目标版本,也必须完成全部复验后方可返回 `ALREADY_CURRENT`。市场在检查与更新之间可能发生变更,若事后身份校验失败,报告错误,不进行自动降级、卸载或覆盖。
76
80
 
77
81
  Kimi 不使用只有仓库 URL 的 Hub 文件证明标签或提交。它先克隆冻结发布标签并核对提交,再进入既有终端交互流程;启动进程保留 `http_proxy`、`https_proxy` 和 `all_proxy`。
78
82
 
@@ -29,7 +29,7 @@ description: "Discoverable entry point for release-skill: dependency and environ
29
29
 
30
30
  治理诊断只运行 release-skill 自己的只读检查程序,不运行目标 Skill、业务脚本、构建、hook 或发布动作,也不把 `prepare`、`verify`、`release-finish` 当作静态治理入口。用户要求实际接入或发布时,把已有授权带到对应原业务入口;各入口继续执行原有确认、副作用和状态机合同。
31
31
 
32
- ## 0.9.34 能力与证据边界
32
+ ## 0.9.36 能力与证据边界
33
33
 
34
34
  四类工程材料接到现有 `release-project` 字段。公开正式材料写入 `publicFiles`(`sourceScope` / `from` / `to` / `mode`)。运行必需资源写入 `requiredPublicFiles`,必须被同一单元 `publicFiles[].to` 精确覆盖。私有正式材料与非正式运行材料不列入 `publicFiles`,需要挡住时使用 `forbiddenPaths` / `forbiddenContentPatterns`。正式不等于公开。是否进入公开快照由 `publicFiles` 是否列出决定。npm 是载荷渠道。`package.json` 的 `files` 与入口闭包和公开映射同时约束。`delivery.include` / `delivery.exclude` 只选择宿主,不是文件包含或排除。排除不得拿掉运行必需资源。互相冲突的配置必须失败关闭。
35
35
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.34",
3
+ "version": "0.9.36",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -19,7 +19,7 @@
19
19
  ],
20
20
  "defaultPrompt": [
21
21
  "Assess this project for release readiness.",
22
- "Prepare a release plan for version 0.9.34.",
22
+ "Prepare a release plan for version 0.9.36.",
23
23
  "Help me understand the release workflow."
24
24
  ]
25
25
  }