principles-disciple 1.236.3 → 1.238.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.
@@ -5,16 +5,15 @@
5
5
  * (TriggerController + EvidenceTriage). Do not add new callers. New admission
6
6
  * logic must use `evaluateTriggerController` from runtime-v2/evidence-triage.
7
7
  *
8
- * Reality note (PRI-752, 2026-09-12): NO runtime routing reads
9
- * `painEvidenceAdmission` / `painEvidenceAdmissionDefault` to re-activate this
10
- * module — the documented flag-off rollback does not exist as code. This
11
- * adapter has ZERO production importers; only tests import it
12
- * (PRI-749 G-1 / PRI-752 finding). The historical PRI-454 removal criteria
13
- * (both flags ON >=30 days + 5 MVP paths verified on Gate B) require
14
- * production evidence this repo does not hold — what IS verified here is
15
- * only the zero-importer / no-routing-effect facts above; disposition awaits
16
- * the Owner decision recorded on PRI-752 —
17
- * see docs/plans/2026-06-pain-evidence-admission-track.md.
8
+ * Reality note (PRI-763, 2026-09-12): the `painEvidenceAdmission` /
9
+ * `painEvidenceAdmissionDefault` flags were RETIRED and REMOVED from the
10
+ * registry (PRI-763) — they never re-activated this module and had zero
11
+ * executable consumers (PRI-651-B1 / PRI-752 / PRI-762). Gate B
12
+ * (TriggerController) is the only admission authority. This adapter keeps
13
+ * ZERO production importers; only tests import it. The module itself is left
14
+ * archived (Phase 5 discipline: core export surface and plugin shim are not
15
+ * removed in the flag-contract PR — retirement of this module is a separate
16
+ * Owner decision).
18
17
  *
19
18
  * The pure decision logic (threshold tree, cooldown comparison, episode-key
20
19
  * construction) now lives in principles-core
@@ -62,11 +62,26 @@ export declare function resetFriction(sessionId: string, workspaceDir?: string,
62
62
  }): SessionState;
63
63
  export declare function trackBlock(sessionId: string): SessionState;
64
64
  export declare function setInjectedProbationIds(sessionId: string, ids: string[], workspaceDir?: string): SessionState;
65
- /** PRI-534: record the principle ids injected into this session's prompt context. */
65
+ /**
66
+ * PRI-534: record the principle ids injected into this session's prompt context.
67
+ * PRI-755 (review fix): call this on EVERY prompt build with the CURRENT set —
68
+ * including an empty one. An empty array is a known-empty round and overwrites
69
+ * a stale non-empty set from an earlier turn; the self-report capture validates
70
+ * against this set, so keeping a stale set would re-admit markers for
71
+ * principles no longer injected.
72
+ */
66
73
  export declare function setInjectedPrincipleIds(sessionId: string | undefined, ids: readonly string[], workspaceDir?: string): void;
67
74
  /** PRI-534: count one applied live auto-correction in this session. */
68
75
  export declare function trackReceiptAutoCorrect(sessionId: string | undefined, workspaceDir?: string): void;
69
76
  export declare function getInjectedProbationIds(sessionId: string, workspaceDir?: string): string[];
77
+ /**
78
+ * PRI-755: read-only view of the principle ids injected into this session's
79
+ * prompt context. Tri-state: an array (possibly empty) means the injection set
80
+ * is KNOWN; undefined means UNKNOWN (session never built a prompt in this
81
+ * process, tracker restarted, or session expired). Receipt capture may only
82
+ * treat verified membership as evidence — unknown must not imply empty.
83
+ */
84
+ export declare function getInjectedPrincipleIds(sessionId: string): readonly string[] | undefined;
70
85
  export declare function clearInjectedProbationIds(sessionId: string, workspaceDir?: string): SessionState;
71
86
  export declare function getSession(sessionId: string): SessionState | undefined;
72
87
  export declare function listSessions(workspaceDir?: string): SessionState[];