@entrorove/skill 0.1.40 → 0.1.43

package/local-stage-boundary.mjs

@@ -0,0 +1,92 @@
+// Delivery-boundary and stop-loss contract (额度可见性与可交付边界 · WP-C).
+//
+// A boundary is the only legal stopping point: it exists where the system is
+// runnable, demonstrable and roll-backable. Stopping at a boundary yields the
+// independent terminal status `delivered-stage-N`; it must never be reported as
+// failed or blocked, and resuming continues at the next boundary without
+// re-running delivered stages.
+//
+// Consumption is measured, never predicted: without an enforced budget there is
+// no baseline, so the decision stays explicitly not-estimable instead of
+// inventing a number.
+const terminalPattern = /^delivered-stage-([1-9][0-9]{0,2})$/u;
+export const STAGE_BOUNDARY_SCHEMA = 'entrorove.stage-boundary/1.0';
+
+export function stageTerminal(count) {
+  if (!Number.isSafeInteger(count) || count < 1 || count > 999) throw new Error('A delivered stage count requires a positive bounded integer');
+  return `delivered-stage-${count}`;
+}
+
+export function stageOf(status) {
+  const match = typeof status === 'string' ? terminalPattern.exec(status) : null;
+  return match ? Number(match[1]) : null;
+}
+
+export function isStageTerminal(status) { return stageOf(status) !== null; }
+
+export function stageMessage(status, remaining) {
+  const stage = stageOf(status);
+  if (stage === null) throw new Error('A delivered stage message requires a delivered terminal status');
+  if (!Number.isSafeInteger(remaining) || remaining < 0) throw new Error('Delivered stages require their remaining bounded count');
+  return remaining === 0
+    ? `阶段 ${stage} 已交付，全部阶段完成。`
+    : `阶段 ${stage} 已交付，剩余 ${remaining} 个阶段待续跑；从下一个边界继续，不重新执行已交付阶段。`;
+}
+
+function measuredMetering(metering) {
+  if (!metering || typeof metering !== 'object' || Array.isArray(metering)) throw new Error('Boundary metering requires the actual consumption view');
+  const { enforced, elapsedMs, maxDurationMs } = metering;
+  if (typeof enforced !== 'boolean') throw new Error('Boundary metering requires its enforcement flag');
+  if (!enforced) return null;
+  if (!Number.isSafeInteger(elapsedMs) || elapsedMs < 0 || !Number.isSafeInteger(maxDurationMs) || maxDurationMs < 1) {
+    throw new Error('Enforced boundary metering requires measured elapsed and bounded duration');
+  }
+  return { elapsedMs, maxDurationMs };
+}
+
+// The decision is taken at a clean boundary: close here when the measured
+// consumption of the stage just delivered reaches the configured share of the
+// enforced budget, otherwise continue to the next boundary.
+export function boundaryDecision(input) {
+  const { steps, deliveredSequence, metering, ratio = 0.8 } = input ?? {};
+  if (!Array.isArray(steps) || steps.length === 0 || steps.some(step => !step || !Number.isSafeInteger(step.sequence))) {
+    throw new Error('Boundary decision requires the accepted plan steps with their sequences');
+  }
+  if (!Number.isSafeInteger(deliveredSequence) || deliveredSequence < 0 || deliveredSequence >= steps.length) {
+    throw new Error('Boundary decision requires a delivered sequence inside the accepted plan');
+  }
+  if (typeof ratio !== 'number' || !(ratio > 0 && ratio <= 1)) throw new Error('Boundary threshold ratio must be inside (0,1]');
+  const remainingStages = steps.length - deliveredSequence;
+  const nextSequence = deliveredSequence + 1;
+  const measured = measuredMetering(metering);
+  if (!measured) {
+    return { schemaVersion: STAGE_BOUNDARY_SCHEMA, action: 'continue', status: null, nextSequence, remainingStages,
+      reason: 'not-estimable', basis: 'none', detail: '没有强制预算基线，不预估剩余量；继续到下一个边界。' };
+  }
+  const consumed = measured.elapsedMs / measured.maxDurationMs;
+  const reached = consumed >= ratio;
+  return { schemaVersion: STAGE_BOUNDARY_SCHEMA, action: reached ? 'close' : 'continue',
+    status: reached ? stageTerminal(deliveredSequence) : null, nextSequence, remainingStages,
+    reason: reached ? 'near-threshold' : 'below-threshold', basis: 'measured',
+    consumedMs: measured.elapsedMs, budgetMs: measured.maxDurationMs, ratio,
+    detail: reached ? '已消耗达到阈值的既定比例，在当前干净边界收口。' : '仍在阈值以内，继续到下一个边界。' };
+}
+
+// Resuming starts at the first stage that was not delivered; delivered stages
+// are never re-executed.
+export function nextBoundary(steps, deliveredSequence) {
+  if (!Array.isArray(steps)) throw new Error('Resuming a boundary requires the accepted plan steps');
+  if (!Number.isSafeInteger(deliveredSequence) || deliveredSequence < 0) throw new Error('Resuming a boundary requires a delivered sequence');
+  return steps.find(step => step.sequence === deliveredSequence + 1) ?? null;
+}
+
+export function stageReport(status, steps) {
+  const delivered = stageOf(status);
+  if (delivered === null || !Array.isArray(steps)) throw new Error('A stage report requires a delivered terminal status and the accepted plan steps');
+  const next = nextBoundary(steps, delivered);
+  return { schemaVersion: STAGE_BOUNDARY_SCHEMA, status, deliveredStages: delivered, totalStages: steps.length,
+    remainingStages: Math.max(0, steps.length - delivered),
+    deliveredStepIds: steps.filter(step => step.sequence <= delivered).map(step => step.stepId ?? null),
+    nextStepId: next?.stepId ?? null, terminal: true,
+    message: stageMessage(status, Math.max(0, steps.length - delivered)) };
+}

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "entrorove.skill-manifest/1.0",
   "name": "entrorove",
-  "version": "0.1.40",
+  "version": "0.1.43",
   "endpoint": "https://entrorove.com",
   "requestSchemaVersion": "entrorove.skill.request/2.0",
   "supportedRequestSchemaVersions": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entrorove/skill",
-  "version": "0.1.40",
+  "version": "0.1.43",
   "type": "module",
   "bin": {
     "entrorove": "cli.mjs"
@@ -14,6 +14,7 @@
     "local-contracts.mjs",
     "local-contract-types.mjs",
     "local-state-lock.mjs",
+    "local-stage-boundary.mjs",
     "local-execution.mjs",
     "local-swarm-authority.mjs",
     "local-swarm-baseline.mjs",
@@ -203,6 +204,7 @@
     "ide-command.mjs",
     "ide-hook.mjs",
     "ide-install.mjs",
+    "install-cleanup.mjs",
     "ide-session.mjs",
     "break-glass.mjs",
     "ide-results.mjs",
@@ -226,6 +228,7 @@
     "runtime/validator-runtime-v7.0.44.d.mts",
     "IDE-EXECUTION.md",
     "REUSE-DISCIPLINE.md",
+    "DELIVERY-BOUNDARIES.md",
     "reuse-discipline-release.mjs"
   ],
   "scripts": {

package/release-state.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": "entrorove.release-state/1.0",
-  "version": "0.1.40",
-  "digest": "4175f36123295cacefbcd09150116696d7528716ba1541256cf345ec3f31a2f3",
+  "version": "0.1.43",
+  "digest": "4def2226e316c684fd009096f1bcafeec0c3519a3d4532cebe203ef095834467",
   "files": {
-    "ide-code-mode.mjs": "cd5318342aac23ba9719ad760b7d7b8018d31839df1bed4ed7142c2782e22def",
-    "ide-command.mjs": "e50a7e0b68bfc1812568f60562598a463ae169984a1abe9d401229c2b66c78c2",
-    "ide-hook.mjs": "567593a4c06911889954dc6499bd22be0ab67c78f0d8d46ad671bf55934f9041",
-    "ide-install.mjs": "65814d1e73cbdccdae4d8703cf9e8573492a3fd6a549ef8562a3f9d703f0ba09",
-    "ide-session.mjs": "964c5088454a9069fbf5672d2456ba136718c3b2e9eec31c96f7c5943972731b",
+    "ide-code-mode.mjs": "f3f53357ba09727b3b597851976a24de93287c0faca5052448277d0904bb61f7",
+    "ide-command.mjs": "158d8f26c1dc28a04284e429150a2060d7278661f656a75e7e9f7600f536b7bf",
+    "ide-hook.mjs": "a2f151a6d1651872b0160487493d3ecedf01e30301b7af3d336201e7f6135e32",
+    "ide-install.mjs": "10247efadcfeef5da001022d12080bd0f789e67fdf7862bcc65db73dda3bbe57",
+    "ide-session.mjs": "ce3ee463804faf4c557d82ff221b0bf7ddb6f6ab7257ce7e9e0af8fbc15d57b8",
     "break-glass.mjs": "2ad6f084c788d63fec11e64412864ac715bcb1a282dd2d8f03dc14e89e82135e",
     "ide-results.mjs": "dfe0d3f773c65a9fc21056538d7005012c982ed4509bc0410d7f62813d0863fd",
     "ide-queue.mjs": "806e716c775fd0079417027b135977c8516f47dddb0bc5ca19e32a355dab0e9e",
@@ -19,9 +19,9 @@
     "local-discipline-gate.mjs": "04b1ba092d7f4342a0e77cfbeb44d9634dbce9fec0c79e6a1e4b11a662d904ac",
     "local-discipline-native.mjs": "8b99b5ce951cab3c1426428ad807650c61c0ffb2c346d747b73b99057b382049",
     "local-discipline-operations.mjs": "9fcb7b8889b7718d42e1d37936485d8198d5017d405e0cdbbabdbbd12fcc9d48",
-    "local-discipline-repository.mjs": "a5f894ec7551ff084fd477eaabff3391fbd7d295df54889649d540f4d64f9a47",
+    "local-discipline-repository.mjs": "d818aa6137459ef200892479cc8c47fe82c884dc0e76dc7e6d45a6b41a13c6ec",
     "local-discipline-snapshot.mjs": "8fd35b2cfbece8f64579f144f589a66dec9b6022d50fe931c4c1f886cb83134d",
-    "local-runner-discipline.mjs": "44694f4444e039d5440805eb051bb4b2b8e2c2412f9e66c2f35f965a16206c3c",
+    "local-runner-discipline.mjs": "86f451de2f1e12a24f5596a29828891c1eba13cd4714ed0c18a77d66cecef934",
     "local-integrity.d.mts": "21357f306234bd841c0d3d90bf2d09f7663f63746f897b9f38190428ae8198b3",
     "local-equivalence-runner.mjs": "df2f406c693c4da7bb30542ec7b4d46a9336f56e9fdd263196c0f3a73d2f6e91",
     "validator-runtime-build.mjs": "da20bd19eb088d79d62e33969b4c075dc2199761b395e40060227f8f86b9519a",
@@ -29,7 +29,7 @@
     "runtime/validator-runtime-v7.0.44.d.mts": "7797edbfe2f7de24da370204dce4dfd22822a1bd80df93514fff900b98afe36f",
     "snapshot-retention.mjs": "4f8919fe8ec49fb4c23e080a8ad2fa3a9282bca3fffe7cf55c64e89ef316697e",
     "snapshot-cleanup-journal.mjs": "76a9684cc95b4eb076e1298d78a9dff37948b00d9607b8f546c599072d3ed331",
-    "IDE-EXECUTION.md": "fe1c65819749fdd7cad4663eab7d11e6e566ef623dc30352e47effe0bd1263d9",
+    "IDE-EXECUTION.md": "64f48dd283f8b7ad76bd33b542baebc3ae4380315c4b7158974927fd4f7a4c17",
     "REUSE-DISCIPLINE.md": "295ecd41c931b00c21d009ab65ac160f0e2ab81b4000ed498d2e8e97c2dc6c63",
     "reuse-discipline-release.mjs": "20ded9c21bd71b8779c454f5eba4c7c0a943ef99d94117b9bbef891d2ab6e3de",
     "local-final-gate16.mjs": "b30caab08441449ad556a6e9a3cefbf91190f0b3f7370f46d2a21156375aa8e3",
@@ -73,15 +73,17 @@
     "local-autocoord17-waits.mjs": "2b0a713987822548a94e1ed3a9a891532db45383797dfc5d5bc8d1e35593cf25",
     "local-validator-isolation17.mjs": "48e94604e28b8fddd567dfb35ff60b73fd094a5803bd49f076388b7f310f92aa",
     "local-calctool-composition17.mjs": "ac89fcb41ab0d0d9b47c1b5696945281b0894eb064820775e36a011c76314e6a",
-    "cli.mjs": "bb99f5a52c770ded055fe27a35b3067ac348441b9488df336e6bf751b803e459",
+    "cli.mjs": "14e27d25acf2838f3eddd24a21ec438baa82650ac2235fb471f15718e996109f",
+    "install-cleanup.mjs": "72bb6bd55382449a986828cd1ae3e98e5fd0bf373f89bbdcc039023ae72a2337",
     "review-client.mjs": "3491eef68ed533174b31db3c53febb6519b8f088f71a9964644714a9a4c03c77",
     "version.mjs": "1f392147d72c40af4b03b307ea607075fb815af5174fa07e254b95fe12dbf3e7",
-    "SKILL.md": "d89c2a83a080a217d67d75fa0251b0f054b92e81a9e40a6c0b52c7ecf3d79099",
+    "SKILL.md": "5531f764b82b3c2fe89592d291d05f508711b1498a65c75219c2b4396b532467",
     "CAPABILITY-MAP.md": "a0f0468a098725ced52a96dd8e22bfc7d1ce7681a8446ebf7dae3696c76c3385",
     "AGREEMENT.md": "f93a68e92c457200dd024610e65f74e478b8f60860f951da818b70561f1b9bf8",
-    "package.json": "a522540d3967d9348a37c6538c1abb39fe6d50872aa8f7f90b85e920590091c7",
+    "DELIVERY-BOUNDARIES.md": "d1bb2895e23fc14bf1c76707bd1f6f03b39695501a78a0b7289dc37b099889dc",
+    "package.json": "8be823b5756da9b393af966a4152bee301cb49f988823aaf757e8c51bf867085",
     "manifest.json": "ab06e307795bc9da5add926752b6c4dbdaf18625090261a035aa356a679c504f",
-    "release.mjs": "5a84da222a179cdc3b6be5db2a4a1c48085de27dff378b7598eb725f0627c98b",
+    "release.mjs": "9b71dc6dbda1e8db1097f0b14dbc1d66b3968ed241813f32851ceef54facec77",
     "local-cli.mjs": "aa4c217c5029408020f76d6c0c5dafc9a0f51216085b2624f3b6aca3cffbe555",
     "local-state-lock.mjs": "1dbf64264642a0851faf043e07ee9f66d2ad0508e9f799b0626246e42fae893e",
     "local-execution.mjs": "46fddd78cd954fb080c660affe90cdaa716695580427336acb820089441a8025",
@@ -114,8 +116,9 @@
     "local-budget-source-bindings.mjs": "cfe97b257fd2da0dd45f95f5e45be20baa6445d11ac6d03538a0105b4985b8ff",
     "local-budget-store.mjs": "2ae36c977ecd32d81f88e2eaa697ce8c228cb4405ecc5c4169cdda104c8ce138",
     "local-budget-transition.mjs": "3894f05d4b5d4d6e16e3f201ff8902e6311cf6434010262934e0d1251aa8b9f0",
-    "local-budget.mjs": "e4ba1b4873a7625f9ff3c43e932b7289e7f95468c9dd88c2aeddd1242d7ea415",
+    "local-budget.mjs": "857bf879addbfbc13bd95d0957b223e05e73a69b8092f1d1933f09ff7968659a",
     "local-flow-lifecycle.mjs": "47534e16599002e5e7cf7d3e95195f4d7a364d2b651ec339d8c6c017d71c1b05",
+    "local-stage-boundary.mjs": "84c3bb5beab29306274c5ca8a78f19a83ed664ae1b93a8372bb493158b304fe3",
     "local-scope-candidate.mjs": "8f0bd9606e70d4a0ebacdd3cd600ec3afed85e2bb3e1760aa1144cf55d4e028a",
     "local-scope-context.mjs": "79753abfc6c76089d17f003a1be537dfaea10d6731c542f7fc53f2a9996ed164",
     "local-scope-files.mjs": "96c301f2a45e5fa22f0b11fb15e5e564f118e53187fc7749263c78d5ed87b056",
@@ -149,7 +152,7 @@
     "local-scope-state.mjs": "8b600a91fc0068d7a8c0bb752ddba7ed30ada93daafb118d6cba2368fd94cb27",
     "local-scope-workspaces.mjs": "a44c34537e5ed2dcaf193a985e5bc05957989fbb160a650f9e37ba7d66eb2de8",
     "local-task-routing.mjs": "6e2e506b2fb0e2e8d8c5147d7df32849b57a4e94a23634f01a355d45735858e4",
-    "remote-client.mjs": "9e4ef758fb7d83e30e82dca68623740e7848cd5a527b7a90846e125d00df0a12",
+    "remote-client.mjs": "8c2450613480d0bdb39e942fb1dea14d74d5ffadd3c72809c74aa5fbc3c8d773",
     "cloud-task-client.mjs": "11acb1a033c94cdfbdfb177a3402ad97f6a5226f577138c8cf6395dc3ebb1a39",
     "scope-runner-client.mjs": "646ab4f80d4a8209e922fd45f40efd968f0744d9dfc03188b222c1a2e11e83b8",
     "native-client.mjs": "6f5575909bae9daba643287f876ffa0f9ff1c53a367b32a40145d740456d6605",
@@ -159,7 +162,7 @@
     "cloud-event-stream.mjs": "e0eec9fc3e0613094523929634f25030df5ca5c5b5fe2c1e1a4586ab10574808",
     "ide-presentation.mjs": "3bac21bfc824fcdad63aafb0d7c3326cd6456923f4224106dd5c38682060f315",
     "automatic-feedback-client.mjs": "75e92f50d6fbfa4f482af36e16c9ce5dd323a02e99eb9b434dcfa3faa846a532",
-    "task-entry-client.mjs": "1ebbbfd26c978e7cb291ab4930974bb86d1fb56f1a702808b8dc348e2cdf69f1",
+    "task-entry-client.mjs": "869f234402c4149eadf1ec138705fc140e2fa16b2a3ea5dc2b2f51dfb189d7de",
     "task-identity.mjs": "e0e6cf1f48bfa5ee3c5cb86a3c21adfce6d66b4220f4a164ca099263c7a09fb4",
     "task-identity.d.mts": "55472e1ffc81b9d5e5c5bd56c0bf1d18ecde03ee5170a58a15ce9caf222d8761",
     "remote-transport.mjs": "93caaca646fca298a4e08142678b134ecc3a657e00de5b9939e2364b2db9d6c4",
@@ -177,12 +180,12 @@
     "local-task-handoff-write-archive.mjs": "3668f39d8ab5664ed717994cf1b4bcc7ea23e146a0e06291f851d30337faeb77",
     "local-task-handoff-write-receipts.mjs": "e1321127bd6fcad7840e185639f81ae68a8722a0ee4264a7b504a02b27887647",
     "workflow-local-runner.mjs": "9fa899a11da2b6b7a436bf9b561641856adcbc5f8b914f6ba89a64dae224900d",
-    "workflow-local-contracts.mjs": "604afa9e97c6dfc3d07b01509ef2476887a2fc219c9e827bcac5d563ab4719e7",
+    "workflow-local-contracts.mjs": "bc52a461727b34c72daa058e1aa77d58206eafad14a93a347537f9969ae51184",
     "workflow-local-client.mjs": "45c954f694d96bf0ea87ee2dc6902a6763dac2cb1df713b6a5e749632054e9af",
     "workflow-local-request.mjs": "4e24c543ce386292a87dc9cd41f90d23375f12079cacffc515c8cd01fd571780",
     "task-message-entry.mjs": "31d10056cb905237cd5649e8eb067009ff1612ec5dc1061e0373209fbc0b646a",
     "task-message-cli.mjs": "3ca65e96c28129b3bd5cac962d106e0859a1f17df1f6a66ee543c6efc22f918d",
-    "local-contracts.mjs": "d47022162233ee0b840bfd808b9d12590f4a367133ef0999233b7f76d76daa43",
+    "local-contracts.mjs": "bb1df682f06782f1c8814d50fe1c455153b29f3a1a093e87dd4ab2ed5ae16e1a",
     "local-contract-types.mjs": "85e71fa4dd67e351a4b67573c740bcdb1661cede53f097189f11837771e75e91",
     "local-archguard-ast.mjs": "7ff7df9dab0d98ed62983add751c80edea598bc94ef4f38ede0ebd4d41226c87",
     "local-archguard-checkpoint.mjs": "37896902520cc995720c96288e4a5ed3585952b55c9c35be281f91fa754c71ec",

package/release.mjs

@@ -48,7 +48,7 @@ const sourceFiles = [
   'local-merge-transaction.mjs',
   ...swarmSourceFiles,
   ...coordination17SourceFiles,
-  'cli.mjs', 'review-client.mjs', 'version.mjs', 'SKILL.md', 'CAPABILITY-MAP.md', 'AGREEMENT.md',
+  'cli.mjs', 'install-cleanup.mjs', 'review-client.mjs', 'version.mjs', 'SKILL.md', 'CAPABILITY-MAP.md', 'AGREEMENT.md', 'DELIVERY-BOUNDARIES.md',
   'package.json', 'manifest.json', 'release.mjs',
   'local-cli.mjs', 'local-state-lock.mjs', 'local-execution.mjs', 'local-integrity.mjs', 'local-evidence-verification.mjs', 'local-formula.mjs', 'local-ledger.mjs',
   'local-error.mjs',
@@ -60,7 +60,7 @@ const sourceFiles = [
   'local-budget-grants.mjs', 'local-budget-handoff.mjs', 'local-budget-handoff-contracts.mjs', 'local-budget-lock.mjs',
   'local-budget-handoff-completion.mjs',
   'local-budget-reads.mjs', 'local-budget-source-bindings.mjs', 'local-budget-store.mjs',
-  'local-budget-transition.mjs', 'local-budget.mjs', 'local-flow-lifecycle.mjs',
+  'local-budget-transition.mjs', 'local-budget.mjs', 'local-flow-lifecycle.mjs', 'local-stage-boundary.mjs',
   'local-scope-candidate.mjs',
   'local-scope-context.mjs',
   'local-scope-files.mjs',
@@ -299,8 +299,10 @@ function releaseLabels() {
     'archguard-runtime-build.mjs': { zh: 'Archguard 架构合同与执行守卫', en: 'Archguard architecture contract and execution guard' },
     'runtime/archguard-runtime-v7.0.44.mjs': { zh: 'Archguard 架构合同与执行守卫', en: 'Archguard architecture contract and execution guard' },
     'cli.mjs': { zh: '技能运行和受管安装', en: 'skill runtime and managed installation' },
+    'install-cleanup.mjs': { zh: '旧版受管安装清理', en: 'managed installation cleanup' },
     'version.mjs': { zh: '版本安全检查', en: 'version safety checks' },
     'SKILL.md': { zh: 'IDE 工作流程说明', en: 'IDE workflow instructions' },
+    'DELIVERY-BOUNDARIES.md': { zh: '任务交付边界说明', en: 'task delivery boundaries' },
     'CAPABILITY-MAP.md': { zh: '能力覆盖映射', en: 'capability coverage map' },
     'AGREEMENT.md': { zh: '使用、隐私与推广告知', en: 'usage, privacy, and promotion notice' },
     'package.json': { zh: '安装包配置', en: 'package configuration' },
@@ -329,6 +331,7 @@ function releaseLabels() {
     'local-budget-transition.mjs': { zh: '候选范围与正式范围预算转换', en: 'candidate and accepted scope budget transition' },
     'local-budget.mjs': { zh: '本地三轴读取预算', en: 'local three-axis read budgets' },
     'local-flow-lifecycle.mjs': { zh: 'Flow 终止与任务解绑', en: 'flow termination and task unbinding' },
+    'local-stage-boundary.mjs': { zh: '本地阶段边界与可恢复停止', en: 'local stage boundaries and recoverable stops' },
     'local-probe.mjs': { zh: '范围探测与分档', en: 'scope probing and tiering' },
     'local-scope-candidate.mjs': { zh: '临时接管范围独立验签', en: 'temporary takeover scope verification' },
     'local-scope-context.mjs': { zh: '精确符号范围绑定', en: 'exact symbol scope binding' },
@@ -400,6 +403,11 @@ const metadata = JSON.parse(await read('package.json'))
 const manifest = JSON.parse(await read('manifest.json'))
 const state = JSON.parse(await read(stateFile))
 const skill = await read('SKILL.md')
+const generatedMetadata = new Set([stateFile, changelogFile, releasesFile])
+const untrackedPackageFiles = metadata.files.filter(name => !generatedMetadata.has(name) && !sourceFiles.includes(name))
+if (untrackedPackageFiles.length) {
+  throw new Error(`Packaged skill files lack release tracking: ${untrackedPackageFiles.join(', ')}`)
+}
 if (metadata.version !== manifest.version || metadata.version !== state.version
   || !skill.includes(`Version: ${metadata.version}.`)) {
   throw new Error('Skill package, manifest, instruction, and release state versions differ')

package/releases.json

@@ -1,4 +1,22 @@
 [
+  {
+    "version": "0.1.43",
+    "date": "2026-10-16",
+    "zh": "更新了Codex 后续轮次工具门禁、复用与变更一致性门禁、IDE 执行与复用纪律文档、技能运行和受管安装、旧版受管安装清理、IDE 工作流程说明、任务交付边界说明、安装包配置、自动版本与更新日志、本地三轴读取预算、本地阶段边界与可恢复停止、远端恢复客户端、账号沙箱偏好与任务入口确认、工作流本地调用契约。",
+    "en": "Updated Codex tool guards across turns, reuse and change consistency checks, IDE execution and reuse discipline documentation, skill runtime and managed installation, managed installation cleanup, IDE workflow instructions, task delivery boundaries, package configuration, automatic versioning and changelog, local three-axis read budgets, local stage boundaries and recoverable stops, remote recovery client, account sandbox preferences and task entry confirmation, workflow local invocation contracts."
+  },
+  {
+    "version": "0.1.42",
+    "date": "2026-10-16",
+    "zh": "修复受管钩子空文件恢复、旧安装清理及仓库控制快照误扫。",
+    "en": "Restored empty managed hook configs, cleaned old installations, and excluded control snapshots from semantic scanning."
+  },
+  {
+    "version": "0.1.41",
+    "date": "2026-10-15",
+    "zh": "修复 0.1.39 受管技能升级与 Codex hook 配置权限误拒；补齐本地 probe/reassess 的 importContexts 输入合同。",
+    "en": "Fixed upgrades from the 0.1.39 managed skill and Codex hook config permission checks; added importContexts to local probe and reassess inputs."
+  },
   {
     "version": "0.1.40",
     "date": "2026-10-15",

package/remote-client.mjs

@@ -1,4 +1,5 @@
 import { createHash } from 'node:crypto';
+import { pathToFileURL } from 'node:url';
 import Ajv from 'ajv';
 import { parseTransportResponse, requestTransport, trustedOrigin } from './remote-transport.mjs';
 import { appendInvocation } from './local-invocations.mjs';
@@ -79,7 +80,8 @@ export async function invokeRemote(data, dependencies) {
     if (['blocked','failed','incomplete'].includes(routed.status)) process.exitCode = 2;
     return routed;
   }
-  const { response, result } = await invokeDiscovered(data, token, { home, apiOrigin });
+  const resolvedApiOrigin = typeof apiOrigin === 'function' ? apiOrigin : () => new URL(apiUrl).origin;
+  const { response, result } = await invokeDiscovered(data, token, { home, apiOrigin: resolvedApiOrigin });
   process.stdout.write(JSON.stringify(presentInvocationNotices(result,dependencies.onIdeEvent,{home})) + '\n');
   if (!response.ok || result.output.status === 'blocked' || result.output.status === 'failed'
     || result.output.status === 'incomplete') process.exitCode = 2;
@@ -233,6 +235,81 @@ export async function queryStatus(requestId, dependencies) {
   process.stdout.write(JSON.stringify(presentInvocationNotices(result,dependencies.onIdeEvent)) + '\n');
 }
 
+// Host quota (WP-D): a declared host adapter may report the host's own
+// remaining quota. Without one, the answer is explicitly unknown and the
+// skill keeps its own measured ledger only.
+export async function hostQuotaView(environment = process.env) {
+  const declared = String(environment.ENTROROVE_IDE_ADAPTER ?? '').split(',').map(value => value.trim()).filter(Boolean);
+  for (const pathname of declared) {
+    let adapter;
+    try { const module = await import(pathToFileURL(pathname).href); adapter = module.default ?? module.adapter; }
+    catch { return { schemaVersion: 'entrorove.host-quota/1.0', state: 'unknown', reason: 'adapter-unavailable', detail: '宿主额度接口无法加载；只按 entrorove 这本账止损。' }; }
+    if (typeof adapter?.hostQuota !== 'function') continue;
+    let value;
+    try { value = await adapter.hostQuota(); }
+    catch { return { schemaVersion: 'entrorove.host-quota/1.0', state: 'unknown', reason: 'adapter-unavailable', detail: '宿主额度接口调用失败；只按 entrorove 这本账止损。' }; }
+    if (value && value.state === 'measured' && Number.isSafeInteger(value.remaining) && value.remaining >= 0) {
+      return { schemaVersion: 'entrorove.host-quota/1.0', state: 'measured', remaining: value.remaining, basis: 'host-reported' };
+    }
+    return { schemaVersion: 'entrorove.host-quota/1.0', state: 'unknown', reason: 'adapter-unavailable', detail: '宿主额度接口未返回可用测量值；只按 entrorove 这本账止损。' };
+  }
+  return { schemaVersion: 'entrorove.host-quota/1.0', state: 'unknown', reason: 'no-host-adapter', detail: '未接入宿主额度接口；只按 entrorove 这本账止损。' };
+}
+
+async function recurringCall(pathname, method, payload, dependencies, label) {
+  const token = await dependencies.readCredential(dependencies.home);
+  const response = await requestTransport(dependencies.apiOrigin(), pathname, { method,
+    headers: { authorization: `Bearer ${token}`, ...(payload ? { 'content-type': 'application/json' } : {}) },
+    ...(payload ? { body: JSON.stringify(payload) } : {}) });
+  if (response.status === 204) return null;
+  const result = await readResponse(response, label);
+  if (!response.ok) throw new Error(`${label} failed: HTTP ${response.status}`);
+  return result;
+}
+
+export async function listRecurring(dependencies) {
+  process.stdout.write(JSON.stringify(await recurringCall('/api/recurring', 'GET', null, dependencies, 'recurring list')) + '\n');
+}
+
+export async function claimRecurring(claimId, dependencies) {
+  const claimed = await recurringCall('/api/recurring/claim', 'POST', { claimId }, dependencies, 'recurring claim');
+  process.stdout.write(JSON.stringify(claimed ?? { claimed: false, detail: '当前没有到期的周期任务。' }) + '\n');
+}
+
+export async function finishRecurring(runId, input, dependencies) {
+  if (!/^[a-f0-9-]{36}$/u.test(runId)) throw new Error('finishing a recurring run requires its runId');
+  process.stdout.write(JSON.stringify(await recurringCall(`/api/recurring/runs/${runId}`, 'POST', input, dependencies, 'recurring finish')) + '\n');
+}
+
+export async function readRecurringRuns(recurringId, dependencies) {
+  if (!/^[a-f0-9-]{36}$/u.test(recurringId)) throw new Error('recurring runs require the original recurringId');
+  process.stdout.write(JSON.stringify(await recurringCall(`/api/recurring/${recurringId}/runs`, 'GET', null, dependencies, 'recurring runs')) + '\n');
+}
+
+export async function queryBillingExport(dependencies) {
+  const token = await dependencies.readCredential(dependencies.home);
+  const response = await readOnlyGet(dependencies.apiOrigin(), '/api/skill/billing-export', { authorization: `Bearer ${token}` }, 'billing export');
+  const result = await readResponse(response, 'billing export');
+  if (response.status === 404) throw new Error('entrorove billing failed: HTTP 404; the reachable server does not expose /api/skill/billing-export yet (deploy the matching API version)');
+  if (!response.ok || result?.schemaVersion !== 'entrorove.billing-export/1.0') {
+    throw new Error(`entrorove billing failed: HTTP ${response.status}`);
+  }
+  process.stdout.write(JSON.stringify(result) + '\n');
+}
+
+export async function queryUsageSummary(flowId, dependencies) {
+  if (flowId !== undefined && !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(flowId)) throw new Error('usage requires an original flowId when given');
+  const path = flowId === undefined ? '/api/skill/usage-summary' : `/api/skill/usage-summary?flowId=${encodeURIComponent(flowId)}`;
+  const token = await dependencies.readCredential(dependencies.home);
+  const response = await readOnlyGet(dependencies.apiOrigin(), path, { authorization: `Bearer ${token}` }, 'usage summary');
+  const result = await readResponse(response, 'usage summary');
+  if (response.status === 404) throw new Error('entrorove usage failed: HTTP 404; the reachable server does not expose /api/skill/usage-summary yet (deploy the matching API version)');
+  if (!response.ok || result?.schemaVersion !== 'entrorove.usage-summary/1.0') {
+    throw new Error(`entrorove usage failed: HTTP ${response.status}`);
+  }
+  process.stdout.write(JSON.stringify({ ...result, hostQuota: await hostQuotaView(dependencies.environment) }) + '\n');
+}
+
 export async function queryFlows(dependencies) {
   const token = await dependencies.readCredential(dependencies.home);
   const response = await readOnlyGet(dependencies.apiOrigin(), '/api/skill/flows', { authorization: `Bearer ${token}` }, 'flow list')

package/task-entry-client.mjs

@@ -5,6 +5,10 @@ import { displayIdeEvent, ideClientHeaders, ideTaskIdentity } from './ide-presen
 /** New IDE tasks use the authenticated account preference; resumes keep their original route. */
 export async function routeTaskEntry(data, token, dependencies) {
   if (data.operation !== 'start' || data.input?.sandboxTaskId) return null;
+  // Older embedders can invoke the remote client without the optional cloud
+  // sandbox preference callback. Keep those callers on the normal API path;
+  // production installs provide the callback and retain the preference gate.
+  if (typeof dependencies.apiOrigin !== 'function') return null;
   const choice = data.sandboxChoice;
   if (choice !== undefined && !['use','local'].includes(choice)) throw new Error('sandboxChoice must be use or local');
   if (choice === 'local') {

package/workflow-local-contracts.mjs

@@ -1,4 +1,5 @@
 import { array, enumeration, integer, ledgerIdentifier, object, relativePath, sha256 } from './local-contract-types.mjs';
+import { DISCIPLINE_POLICY_SCHEMA } from './local-discipline-contracts.mjs';
 
 const exact = properties => object(properties, Object.keys(properties));
 const boundedArray = (items, minimum, maximum) => ({ ...array(items, minimum), maxItems: maximum });
@@ -17,6 +18,7 @@ const executionPolicy = exact({ executable: absolutePath, executableSha256: sha2
     additionalProperties: { type: 'string', maxLength: 16_384, pattern: '^[^\\u0000]*$' } },
   timeoutMs: integer(1, 300_000), maxOutputBytes: integer(1, 1024 * 1024), requiredExitCode: { const: 0 },
 });
+executionPolicy.properties.discipline = DISCIPLINE_POLICY_SCHEMA;
 const baseline = exact({ schemaVersion: { const: 'validator.golden-baseline/1.0' }, baselineId: id,
   source: exact({ kind: enumeration(['repository-commit', 'artifact', 'approved-record']), locator: shortText, digestSha256: sha256 }),
   version: id, frozen: { const: true }, frozenAt: timestamp, frozenBy: id, testsSha256: sha256,