instar 1.3.1065 → 1.3.1066

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 (10) hide show
  1. package/dist/data/standards-registry.meta.json +1 -1
  2. package/dist/providers/costAwareRouting.d.ts.map +1 -1
  3. package/dist/providers/costAwareRouting.js +5 -2
  4. package/dist/providers/costAwareRouting.js.map +1 -1
  5. package/package.json +1 -1
  6. package/src/data/builtin-manifest.json +2 -2
  7. package/src/data/standards-registry.meta.json +1 -1
  8. package/upgrades/{1.3.1065.md → 1.3.1066.md} +13 -0
  9. package/upgrades/eli16/sdk-credit-zero-total.md +17 -0
  10. package/upgrades/side-effects/sdk-credit-zero-total.md +92 -0
package/dist/data/standards-registry.meta.json CHANGED
@@ -2,5 +2,5 @@
2
2
  "sha256": "b75c147afd1f5a9843ca4eac372159f3623f24731fe63b2f59e48043ae488af9",
3
3
  "articleCount": 82,
4
4
  "generatedFrom": "docs/STANDARDS-REGISTRY.md",
5
- "packageVersion": "1.3.1065"
5
+ "packageVersion": "1.3.1066"
6
6
  }
package/dist/providers/costAwareRouting.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"costAwareRouting.d.ts","sourceRoot":"","sources":["../../src/providers/costAwareRouting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE/F;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,MAAO,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5D;;;OAGG;IACH,kBAAkB,EAAE,UAAU,CAAC;IAC/B;;;OAGG;IACH,qBAAqB,EAAE,UAAU,CAAC;IAClC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,EACvC,oBAAoB,EAAE,MAAM,GAC3B;IAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBzD;AAED,qBAAa,sBAAuB,YAAW,aAAa;IAG9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,OAAO,EAAE,uBAAuB;IASvD,MAAM,CACV,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAC1C,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAqC5B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE;QACf,gCAAgC;QAChC,YAAY,EAAE,MAAM,CAAC;QACrB,wCAAwC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,kEAAkE;QAClE,eAAe,EAAE,MAAM,CAAC;QACxB,mDAAmD;QACnD,WAAW,EAAE,OAAO,CAAC;QACrB,2CAA2C;QAC3C,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5D,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAElB,OAAO,EAAE,uBAAuB;IAK7D,4CAA4C;IACtC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAyB5C;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI;CAwBrF"}
1
+ {"version":3,"file":"costAwareRouting.d.ts","sourceRoot":"","sources":["../../src/providers/costAwareRouting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE/F;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,MAAO,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5D;;;OAGG;IACH,kBAAkB,EAAE,UAAU,CAAC;IAC/B;;;OAGG;IACH,qBAAqB,EAAE,UAAU,CAAC;IAClC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,EACvC,oBAAoB,EAAE,MAAM,GAC3B;IAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBzD;AAED,qBAAa,sBAAuB,YAAW,aAAa;IAG9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,OAAO,EAAE,uBAAuB;IASvD,MAAM,CACV,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,EAC1C,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;CAqC5B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE;QACf,gCAAgC;QAChC,YAAY,EAAE,MAAM,CAAC;QACrB,wCAAwC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,kEAAkE;QAClE,eAAe,EAAE,MAAM,CAAC;QACxB,mDAAmD;QACnD,WAAW,EAAE,OAAO,CAAC;QACrB,2CAA2C;QAC3C,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5D,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAElB,OAAO,EAAE,uBAAuB;IAK7D,4CAA4C;IACtC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA6B5C;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI;CAwBrF"}
package/dist/providers/costAwareRouting.js CHANGED
@@ -128,14 +128,17 @@ export class CostStateTracker {
128
128
  snapshot = null;
129
129
  }
130
130
  const result = { capturedAt: new Date().toISOString() };
131
- if (snapshot !== null) {
131
+ if (snapshot !== null
132
+ && Number.isFinite(snapshot.totalUsd)
133
+ && snapshot.totalUsd > 0
134
+ && Number.isFinite(snapshot.remainingUsd)) {
132
135
  const safetyMarginUsd = this.safetyMarginFraction * snapshot.totalUsd;
133
136
  result.agentSdkCredit = {
134
137
  remainingUsd: snapshot.remainingUsd,
135
138
  totalUsd: snapshot.totalUsd,
136
139
  safetyMarginUsd,
137
140
  belowMargin: snapshot.remainingUsd <= safetyMarginUsd,
138
- consumedFraction: snapshot.totalUsd > 0 ? 1 - snapshot.remainingUsd / snapshot.totalUsd : 0,
141
+ consumedFraction: 1 - snapshot.remainingUsd / snapshot.totalUsd,
139
142
  };
140
143
  }
141
144
  else {
package/dist/providers/costAwareRouting.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"costAwareRouting.js","sourceRoot":"","sources":["../../src/providers/costAwareRouting.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"costAwareRouting.js","sourceRoot":"","sources":["../../src/providers/costAwareRouting.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instar",
3
- "version": "1.3.1065",
3
+ "version": "1.3.1066",
4
4
  "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
package/src/data/builtin-manifest.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "./builtin-manifest.schema.json",
3
3
  "schemaVersion": 1,
4
- "generatedAt": "2026-07-29T13:39:21.529Z",
5
- "instarVersion": "1.3.1065",
4
+ "generatedAt": "2026-07-29T13:44:01.441Z",
5
+ "instarVersion": "1.3.1066",
6
6
  "entryCount": 202,
7
7
  "entries": {
8
8
  "hook:session-start": {
package/src/data/standards-registry.meta.json CHANGED
@@ -2,5 +2,5 @@
2
2
  "sha256": "b75c147afd1f5a9843ca4eac372159f3623f24731fe63b2f59e48043ae488af9",
3
3
  "articleCount": 82,
4
4
  "generatedFrom": "docs/STANDARDS-REGISTRY.md",
5
- "packageVersion": "1.3.1065"
5
+ "packageVersion": "1.3.1066"
6
6
  }
package/upgrades/{1.3.1065.md → 1.3.1066.md} RENAMED
@@ -9,6 +9,10 @@ Red-team boundary maps now return `derivationRatio: null` when no probe produced
9
9
  a refusal. A measured zero remains zero when refusals exist but none are
10
10
  grounded.
11
11
 
12
+ The cost-state tracker now treats SDK-credit snapshots with a non-positive or
13
+ non-finite total as unknown. A zero remaining balance with a valid positive
14
+ total remains measurable as fully consumed.
15
+
12
16
  Self-knowledge validation now reports `coverageScore: null` when a tree contains
13
17
  no nodes. The audit result and HTTP health response preserve that state, and
14
18
  the machine check renders `coverage n/a` instead of `0% coverage`.
@@ -18,6 +22,9 @@ the machine check renders `coverage n/a` instead of `0% coverage`.
18
22
  A scenario run with no refusal denominator no longer reports a zero-percent
19
23
  grounded-refusal ratio.
20
24
 
25
+ An invalid zero-total credit pot no longer looks like a known, zero-percent
26
+ consumed budget.
27
+
21
28
  An empty self-knowledge tree no longer looks like a measured zero-percent
22
29
  coverage result; the health surfaces say coverage is unavailable.
23
30
 
@@ -26,6 +33,9 @@ coverage result; the health surfaces say coverage is unavailable.
26
33
  - Explicit unmeasured state for refusal derivation coverage.
27
34
  - Separate test coverage for absent and measured-zero denominators.
28
35
 
36
+ - Validated SDK-credit denominator at the tracker boundary.
37
+ - Consistent unknown-state behavior with the existing HTTP comparison route.
38
+
29
39
  - Explicit unmeasured coverage for zero-node trees.
30
40
  - Consistent audit, API, and CLI presentation of the missing denominator.
31
41
 
@@ -35,6 +45,9 @@ coverage result; the health surfaces say coverage is unavailable.
35
45
  - Full repository lint and TypeScript checks pass.
36
46
  - Restoring the old zero fallback makes the no-refusal test fail.
37
47
 
48
+ - Fifty focused cost-state and routing-cache tests pass.
49
+ - Restoring the zero-total snapshot object makes the boundary test fail.
50
+
38
51
  - Validation and audit tests cover a valid zero-node tree.
39
52
  - Twenty-eight focused tests and full lint pass.
40
53
  - Restoring the old zero fallback makes the validation test fail.
package/upgrades/eli16/sdk-credit-zero-total.md ADDED
@@ -0,0 +1,17 @@
1
+ # A zero-total credit pot is no longer treated as known
2
+
3
+ The cost-state tracker records how much of an SDK credit pot has been consumed.
4
+ That percentage needs a positive total credit amount.
5
+
6
+ Previously, a provider snapshot with total credit equal to zero still produced
7
+ a “known” object. Its consumed fraction became zero, which looked like a fresh,
8
+ unused budget, while the same object also said the remaining amount was at or
9
+ below its zero-dollar safety margin. The HTTP comparison route already treated
10
+ a non-positive total as unknown, so two routes disagreed about the same input.
11
+
12
+ The tracker now returns its existing unknown state when total credit is not a
13
+ finite positive number or remaining credit is non-finite. A real zero remaining
14
+ balance with a positive total stays valid and reports fully consumed.
15
+
16
+ Tests cover both sides. Restoring the old object for a zero total makes the new
17
+ boundary test fail.
package/upgrades/side-effects/sdk-credit-zero-total.md ADDED
@@ -0,0 +1,92 @@
1
+ # Side-Effects Review — SDK-credit zero total
2
+
3
+ **Version / slug:** `sdk-credit-zero-total`
4
+ **Date:** `2026-07-29`
5
+ **Author:** `instar-codey`
6
+ **Second-pass reviewer:** `not required`
7
+
8
+ ## Summary of the change
9
+
10
+ `CostStateTracker.snapshot()` maps invalid total-credit denominators to its
11
+ existing `agentSdkCredit: null` state.
12
+
13
+ ## Decision-point inventory
14
+
15
+ - SDK-credit snapshot validation — modified.
16
+ - Material-shift comparison — unchanged; it already handles known/unknown
17
+ transitions.
18
+ - Routing policy — unchanged.
19
+
20
+ ## 1. Over-block
21
+
22
+ Positive finite totals preserve prior behavior, including a zero remaining
23
+ balance.
24
+
25
+ ## 2. Under-block
26
+
27
+ Zero, negative, and non-finite totals cannot produce a known consumed fraction.
28
+ Non-finite remaining values are rejected at the same boundary.
29
+
30
+ ## 3. Level-of-abstraction fit
31
+
32
+ The tracker is the first shared layer that constructs the cached cost-state
33
+ shape. The HTTP comparison route already uses the same denominator rule.
34
+
35
+ ## 4. Signal vs authority compliance
36
+
37
+ **Required reference:** [docs/signal-vs-authority.md](../../docs/signal-vs-authority.md)
38
+
39
+ - [x] Yes — the tracker supplies a signal to cache invalidation.
40
+
41
+ Unknown state may invalidate a cached choice through the existing
42
+ known-to-unknown reason; it does not select a provider by itself.
43
+
44
+ ## 4b. Judgment-point check
45
+
46
+ No heuristic threshold change. Denominator validity is deterministic.
47
+
48
+ ## 5. Interactions
49
+
50
+ - **Shadowing:** invalid totals use the established null state.
51
+ - **Double-fire:** one material-shift reason at most.
52
+ - **Races:** snapshot timing and TTL behavior are unchanged.
53
+ - **Feedback loops:** valid provider snapshots are byte-for-byte equivalent.
54
+
55
+ ## 6. External surfaces
56
+
57
+ Consumers see `agentSdkCredit: null` instead of a contradictory zero-total
58
+ object.
59
+
60
+ ## 6b. Operator-surface quality
61
+
62
+ Zero total can no longer look like zero consumption.
63
+
64
+ ## 7. Multi-machine posture
65
+
66
+ Local provider state only; the same validation applies wherever the tracker is
67
+ constructed.
68
+
69
+ ## 8. Rollback cost
70
+
71
+ Pure validation rollback. No persistence.
72
+
73
+ ## Conclusion
74
+
75
+ Clear to ship as a bounded cost-state consistency correction.
76
+
77
+ ## Second-pass review
78
+
79
+ **Reviewer:** not required
80
+ **Independent read of the artifact:** Not required; no provider-selection
81
+ threshold or authority changes.
82
+
83
+ ## Evidence pointers
84
+
85
+ - `tests/unit/providers/costAwareRouting.test.ts`
86
+ - `tests/unit/providers/uxConfirm/TriggerGate.test.ts`
87
+ - `tests/unit/providers/uxConfirm/FrameworkModelRouter.test.ts`
88
+ - Mutation proof: restoring the zero-total object fails the boundary test.
89
+
90
+ ## Class-Closure Declaration
91
+
92
+ No agent-authored-artifact defect — not applicable.