@clossys/butler 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -3,6 +3,40 @@
 All notable changes to this package are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.1.6] - 2026-09-18
+
+### Added
+
+- Stated the charter close condition in the README: independent consumer
+  evidence of `confirmed current intent rate`, computed by
+  `assessConfirmedCurrentIntentRate()`. An empty evaluated set is
+  indeterminate, never a perfect rate of 1. `checkConfirmationCompleteness`
+  and `checkCurrency` remain the gates they are; neither is this rate.
+- Declared `foundry.assessment` against a new mapped `butler-rate-check`
+  bin with `invocation: "single-json-input"`. `butler-check` remains the
+  three-gate CLI and is not the assessment surface. Advisor remains the
+  only required first-day role.
+- `butler-rate-check assessment.json`: prints the `confirmed current intent
+  rate` report and exits on the `0` / `1` / `2` ternary.
+
+### Notes
+
+- This does not claim the position is closed. Qualification of `0.1.6` is
+  deferred under #833.
+
+## [0.1.5] - 2026-09-17
+
+### Fixed
+
+- Removed a doc-comment citation in `src/schema.ts` that pointed at a
+  repository-root agent-policy file. `src/` is packed content and compiles
+  into `dist/`, so that comment reached an installed consumer while the file
+  it named did not: `files` carries `dist`, `src`, this changelog, the README
+  and the licence, and nothing from the repository root. The sentence now
+  states the hand-rolled-validation convention on its own, which is the part
+  a reader of the installed package can actually act on. No type, export,
+  signature, or runtime behaviour changed.
+
 ## [0.1.4] - 2026-09-16
 
 ### Fixed
@@ -16,6 +50,7 @@ All notable changes to this package are documented here. Format follows
   installs anonymously. A reader following the instruction as written
   would create a credential this package never asks for. (#924)
 
+
 ## [0.1.3] - 2026-09-02
 
 ### Fixed

package/README.md

@@ -52,10 +52,48 @@ GitHub token or other credential.
 import { checkCurrency, evaluateStandingInstruction } from "@clossys/butler";
 ```
 
+## Confirmed current intent rate
+
+Independent consumer evidence shows the position's owned metric meets its
+setpoint over the declared review cadence. The owned metric is `confirmed
+current intent rate`, computed by `assessConfirmedCurrentIntentRate()`. An
+empty evaluated set is `indeterminate`, never a perfect rate of 1.
+`checkConfirmationCompleteness` and `checkCurrency` remain the gates they
+are; neither is this rate. This package does not measure consumer evidence
+and does not close the loop. A green run of this package's tests is not a
+close.
+
+```ts
+import { assessConfirmedCurrentIntentRate } from "@clossys/butler";
+
+const report = assessConfirmedCurrentIntentRate(input);
+```
+
+```bash
+butler-rate-check assessment.json
+```
+
+The command prints JSON and exits `0` for satisfied, `1` for violated, and
+`2` for indeterminate, unreadable, or invalid input.
+
+This package declares that command as its first-day assessment surface in
+its own manifest:
+
+```json
+"foundry": { "assessment": { "bin": "butler-rate-check", "invocation": "single-json-input" } }
+```
+
+Onboarding discovers that declaration from the installed manifest and never
+infers a surface. `butler-check` remains the three-gate CLI and is not the
+assessment surface. Butler is not a required first-day role; Advisor
+remains the only required first-day assessment.
+
 ## The three gates
 
 All three are reachable from one installed bin, `butler-check`, dispatched
-on the first argument matching a gate name exactly.
+on the first argument matching a gate name exactly. The charter assessment
+is a second mapped bin, `butler-rate-check`, and is not a fourth gate on
+this dispatcher.
 
 ```bash
 butler-check confirmation-completeness ./intents.json ./confirmations.json --floor 0.8
@@ -140,6 +178,8 @@ Everything below is exported from the package root.
 | `checkConfirmationCompleteness` | Gate 1, over intents, confirmations, and a declared floor. |
 | `checkCurrency` | Gate 2, over instructions, usages, and the caller's denial-invalidation decision. |
 | `checkWithdrawalParity` | Gate 3, over measured preference paths. |
+| `assessConfirmedCurrentIntentRate` | Charter close metric. Returns `ConfirmedCurrentIntentRateAssessment` from consumer-supplied independent observations. Not `checkConfirmationCompleteness` or `checkCurrency`. |
+| `ConfirmedCurrentIntentRateAssessment`, `ConfirmedCurrentIntentRateFinding`, `ConfirmedCurrentIntentRateState` | Its result shape |
 
 ### Validators and guards
 

package/dist/confirmed-current-intent-rate-cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export declare class ButlerRateCliInputError extends Error {
+}
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export declare function readButlerAssessmentJson(path: string): unknown;
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export declare function main(argv: readonly string[]): number;
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export declare function isDirectInvocation(moduleUrl: string, argvPath: string | undefined): boolean;
+//# sourceMappingURL=confirmed-current-intent-rate-cli.d.ts.map

package/dist/confirmed-current-intent-rate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmed-current-intent-rate-cli.d.ts","sourceRoot":"","sources":["../src/confirmed-current-intent-rate-cli.ts"],"names":[],"mappings":";AAQA,qBAAa,uBAAwB,SAAQ,KAAK;CAAG;AAErD,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9D;AAED,4FAA4F;AAC5F,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CASpD;AAWD,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAO3F"}

package/dist/confirmed-current-intent-rate-cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessConfirmedCurrentIntentRate } from "./confirmed-current-intent-rate.js";
+const USAGE = `Usage: butler-rate-check <assessment.json>\n\nAssess confirmed current intent rate from consumer-supplied independent observations.\nExit codes: 0 = satisfied, 1 = violated, 2 = indeterminate or unreadable.\nbutler-check remains the three-gate CLI and is not this assessment.`;
+export class ButlerRateCliInputError extends Error {
+}
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export function readButlerAssessmentJson(path) {
+    const resolved = resolve(path);
+    if (!existsSync(resolved))
+        throw new ButlerRateCliInputError(`assessment file "${path}" does not exist`);
+    try {
+        if (!statSync(resolved).isFile())
+            throw new ButlerRateCliInputError(`assessment file "${path}" is not a file`);
+        return JSON.parse(readFileSync(resolved, "utf8"));
+    }
+    catch (cause) {
+        if (cause instanceof ButlerRateCliInputError)
+            throw cause;
+        throw new ButlerRateCliInputError(`assessment file "${path}" is unreadable JSON: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+}
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export function main(argv) {
+    if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (argv.length !== 1)
+        throw new ButlerRateCliInputError("exactly one assessment.json file is required");
+    const report = assessConfirmedCurrentIntentRate(readButlerAssessmentJson(argv[0]));
+    console.log(JSON.stringify(report, null, 2));
+    return report.state === "satisfied" ? 0 : report.state === "violated" ? 1 : 2;
+}
+function run() {
+    try {
+        process.exitCode = main(process.argv.slice(2));
+    }
+    catch (cause) {
+        console.error(`butler-rate-check: ${cause instanceof Error ? cause.message : String(cause)}`);
+        process.exitCode = 2;
+    }
+}
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export function isDirectInvocation(moduleUrl, argvPath) {
+    if (argvPath === undefined)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(resolve(argvPath));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectInvocation(import.meta.url, process.argv[1]))
+    run();
+//# sourceMappingURL=confirmed-current-intent-rate-cli.js.map

package/dist/confirmed-current-intent-rate-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmed-current-intent-rate-cli.js","sourceRoot":"","sources":["../src/confirmed-current-intent-rate-cli.ts"],"names":[],"mappings":"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"}

package/dist/confirmed-current-intent-rate.d.ts

@@ -0,0 +1,23 @@
+export type ConfirmedCurrentIntentRateState = "satisfied" | "violated" | "indeterminate";
+export interface ConfirmedCurrentIntentRateFinding {
+    readonly rule: string;
+    readonly severity: "error";
+    readonly message: string;
+    readonly path?: string;
+}
+export interface ConfirmedCurrentIntentRateAssessment {
+    readonly metric: "confirmed current intent rate";
+    readonly state: ConfirmedCurrentIntentRateState;
+    readonly rate: number | null;
+    readonly evaluatedIntents: number;
+    readonly confirmedCurrentIntents: number;
+    readonly findings: readonly ConfirmedCurrentIntentRateFinding[];
+    readonly proposedPositions: readonly unknown[];
+}
+/**
+ * Computes `confirmed current intent rate`: evaluated acted requests and
+ * standing-instruction uses backed by current subject confirmation / all
+ * acted requests and standing-instruction uses evaluated.
+ */
+export declare function assessConfirmedCurrentIntentRate(input: unknown): ConfirmedCurrentIntentRateAssessment;
+//# sourceMappingURL=confirmed-current-intent-rate.d.ts.map

package/dist/confirmed-current-intent-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmed-current-intent-rate.d.ts","sourceRoot":"","sources":["../src/confirmed-current-intent-rate.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,+BAA+B,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC;AAEzF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iCAAiC,EAAE,CAAC;IAChE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,OAAO,EAAE,CAAC;CAChD;AAwDD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,oCAAoC,CAmGrG"}

package/dist/confirmed-current-intent-rate.js

@@ -0,0 +1,149 @@
+/**
+ * Computes the Butler charter metric `confirmed current intent rate` from
+ * consumer-supplied independent observations.
+ *
+ * This module does not invent observations and does not relabel
+ * `checkConfirmationCompleteness` or `checkCurrency`. An empty evaluated
+ * set is indeterminate, never a perfect rate of 1. Withdrawal-parity is
+ * not this rate.
+ */
+const METRIC = "confirmed current intent rate";
+const RESERVED_OBSERVERS = new Set(["butler", "@clossys/butler"]);
+const PROPOSED_POSITIONS = [];
+const KINDS = new Set(["acted-request", "standing-instruction-use"]);
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function timestamp(value) {
+    return text(value) && !Number.isNaN(Date.parse(value));
+}
+function finding(rule, message, path) {
+    return path === undefined ? { rule, severity: "error", message } : { rule, severity: "error", message, path };
+}
+function evidenceCounts(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return false;
+    return value.every((item) => record(item) && text(item.id) && text(item.description));
+}
+function reservedObserver(value) {
+    return RESERVED_OBSERVERS.has(value.trim().toLowerCase());
+}
+function report(state, evaluatedIntents, confirmedCurrentIntents, rate, findings) {
+    return {
+        metric: METRIC,
+        state,
+        rate,
+        evaluatedIntents,
+        confirmedCurrentIntents,
+        findings,
+        proposedPositions: PROPOSED_POSITIONS,
+    };
+}
+function isConfirmedCurrent(entry) {
+    return entry.confirmed && entry.current;
+}
+/**
+ * Computes `confirmed current intent rate`: evaluated acted requests and
+ * standing-instruction uses backed by current subject confirmation / all
+ * acted requests and standing-instruction uses evaluated.
+ */
+export function assessConfirmedCurrentIntentRate(input) {
+    if (!record(input)) {
+        return report("indeterminate", 0, 0, null, [finding("assessment-shape", "Assessment input must be an object.", "$")]);
+    }
+    const findings = [];
+    if (!timestamp(input.asOf)) {
+        findings.push(finding("assessment-as-of", "asOf must be an interpretable timestamp.", "asOf"));
+    }
+    const declaredIntents = input.declaredIntents;
+    if (!Array.isArray(declaredIntents)) {
+        findings.push(finding("declared-intents-required", "declaredIntents must be an array of { id, kind } objects.", "declaredIntents"));
+        return report("indeterminate", 0, 0, null, findings);
+    }
+    const declaredIds = [];
+    const declaredSet = new Set();
+    declaredIntents.forEach((item, index) => {
+        const path = `declaredIntents[${index}]`;
+        if (!record(item) || !text(item.id)) {
+            findings.push(finding("intent-id-required", "id must be a non-empty string.", `${path}.id`));
+            return;
+        }
+        if (!text(item.kind) || !KINDS.has(item.kind)) {
+            findings.push(finding("intent-kind-required", 'kind must be "acted-request" or "standing-instruction-use".', `${path}.kind`));
+            return;
+        }
+        if (declaredSet.has(item.id)) {
+            findings.push(finding("duplicate-intent-id", `Duplicate id "${item.id}".`, `${path}.id`));
+            return;
+        }
+        declaredSet.add(item.id);
+        declaredIds.push(item.id);
+    });
+    if (declaredIds.length === 0) {
+        findings.push(finding("declared-intents-empty", "No declared intents are available for the confirmed-current-intent metric; the rate is indeterminate, never 1.", "declaredIntents"));
+    }
+    const observations = input.observations;
+    if (observations !== undefined && !Array.isArray(observations)) {
+        findings.push(finding("observations-shape", "observations must be an array.", "observations"));
+    }
+    const counting = new Map();
+    if (Array.isArray(observations)) {
+        observations.forEach((item, index) => {
+            const path = `observations[${index}]`;
+            if (!record(item)) {
+                findings.push(finding("observation-shape", "An observation must be an object.", path));
+                return;
+            }
+            if (text(item.observerRef) && reservedObserver(item.observerRef)) {
+                findings.push(finding("self-observation", "Butler cannot observe itself; reserved observerRef values are not independent.", `${path}.observerRef`));
+                return;
+            }
+            if (text(item.intentId) && !declaredSet.has(item.intentId)) {
+                findings.push(finding("unknown-intent", `Observation intentId "${item.intentId}" is not a declared intent.`, `${path}.intentId`));
+                return;
+            }
+            if (item.independent !== true)
+                return;
+            if (typeof item.confirmed !== "boolean" || typeof item.current !== "boolean")
+                return;
+            if (!text(item.observerRef) || !evidenceCounts(item.evidence) || !text(item.intentId) || !declaredSet.has(item.intentId))
+                return;
+            const bucket = counting.get(item.intentId) ?? [];
+            bucket.push({ confirmed: item.confirmed, current: item.current });
+            counting.set(item.intentId, bucket);
+        });
+    }
+    let evaluatedIntents = 0;
+    let confirmedCurrentIntents = 0;
+    for (const id of declaredIds) {
+        const observed = counting.get(id) ?? [];
+        if (observed.length === 0) {
+            findings.push(finding("intent-unevaluated", `Declared intent "${id}" has no counting independent observation.`, `declaredIntents.${id}`));
+            continue;
+        }
+        evaluatedIntents += 1;
+        const allConfirmedCurrent = observed.every((entry) => isConfirmedCurrent(entry));
+        if (allConfirmedCurrent)
+            confirmedCurrentIntents += 1;
+        else {
+            findings.push(finding("intent-not-confirmed-current", `Declared intent "${id}" was independently observed without current subject confirmation.`, `declaredIntents.${id}`));
+        }
+        if (observed.length > 1) {
+            const first = observed[0];
+            if (observed.some((entry) => entry.confirmed !== first.confirmed || entry.current !== first.current)) {
+                findings.push(finding("observation-disagreement", `Counting observations for "${id}" disagree.`, `observations.${id}`));
+            }
+        }
+    }
+    const rate = evaluatedIntents === 0 ? null : confirmedCurrentIntents / evaluatedIntents;
+    if (evaluatedIntents === 0)
+        return report("indeterminate", 0, 0, null, findings);
+    const coverageComplete = evaluatedIntents === declaredIds.length;
+    const noErrorFindings = findings.length === 0;
+    const state = coverageComplete && confirmedCurrentIntents === evaluatedIntents && noErrorFindings ? "satisfied" : "violated";
+    return report(state, evaluatedIntents, confirmedCurrentIntents, rate, findings);
+}
+//# sourceMappingURL=confirmed-current-intent-rate.js.map

package/dist/confirmed-current-intent-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmed-current-intent-rate.js","sourceRoot":"","sources":["../src/confirmed-current-intent-rate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -29,7 +29,11 @@
  *      `checkCurrency`, and `checkWithdrawalParity`. Each is a pure
  *      function returning a three-state result, and `cli.ts` folds those
  *      onto the `0`/`1`/`2` exit contract without ever collapsing "could
- *      not run" into either "clean" or "findings".
+ *      not run" into either "clean" or "findings". The charter metric
+ *      `confirmed current intent rate` is computed by
+ *      `assessConfirmedCurrentIntentRate` from consumer-supplied
+ *      independent observations and is not either gate. `butler-rate-check`
+ *      is the assessment surface; `butler-check` remains the three-gate CLI.
  *
  * Two subpaths sit beside this one. `./inbound` is admission — whether an
  * event arriving on a channel should be acknowledged and processed at all,
@@ -45,6 +49,8 @@
 export { CONFIRMATION_VERDICTS, INTENT_DISPOSITIONS, STANDING_AUDIT_EVENT_TYPES, STANDING_PROVENANCES, isConfirmationRecord, isIntentRecord, isStandingInstruction, validateConfidenceFloor, validateConfirmationRecord, validateConfirmationRecords, validateInstructionUsages, validateIntentRecord, validateIntentRecords, validatePolicyVersion, validatePreferencePaths, validateStandingInstruction, validateStandingInstructions, } from "./schema.js";
 export type { ConfidenceFloor, ConfirmationRecord, ConfirmationVerdict, CurrencyWindow, InstructionUsage, IntentDisposition, IntentRecord, PathCost, PolicyVersion, PreferencePath, StandingAction, StandingAuditEvent, StandingAuditEventType, StandingAuditLedger, StandingEvaluation, StandingEvaluationPolicy, StandingInstruction, StandingInstructionStore, StandingProvenance, StandingState, StandingTopic, } from "./schema.js";
 export { checkConfirmationCompleteness, checkCurrency, checkWithdrawalParity, decideStandingChange, evaluateStandingInstruction, recordReopened, recordStaleness, } from "./contract.js";
+export { assessConfirmedCurrentIntentRate } from "./confirmed-current-intent-rate.js";
+export type { ConfirmedCurrentIntentRateAssessment, ConfirmedCurrentIntentRateFinding, ConfirmedCurrentIntentRateState, } from "./confirmed-current-intent-rate.js";
 export type { ConfirmationCompletenessResult, ConfirmationFailureReason, ConfirmationFinding, ConfirmationFindingKind, CurrencyFailureReason, CurrencyFinding, CurrencyFindingKind, CurrencyResult, WithdrawalParityFailureReason, WithdrawalParityFinding, WithdrawalParityFindingKind, WithdrawalParityResult, } from "./contract.js";
 export type { ValidationIssue, ValidationResult, Validator } from "./validation.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AACtF,YAAY,EACV,oCAAoC,EACpC,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -29,7 +29,11 @@
  *      `checkCurrency`, and `checkWithdrawalParity`. Each is a pure
  *      function returning a three-state result, and `cli.ts` folds those
  *      onto the `0`/`1`/`2` exit contract without ever collapsing "could
- *      not run" into either "clean" or "findings".
+ *      not run" into either "clean" or "findings". The charter metric
+ *      `confirmed current intent rate` is computed by
+ *      `assessConfirmedCurrentIntentRate` from consumer-supplied
+ *      independent observations and is not either gate. `butler-rate-check`
+ *      is the assessment surface; `butler-check` remains the three-gate CLI.
  *
  * Two subpaths sit beside this one. `./inbound` is admission — whether an
  * event arriving on a channel should be acknowledged and processed at all,
@@ -44,4 +48,5 @@
  */
 export { CONFIRMATION_VERDICTS, INTENT_DISPOSITIONS, STANDING_AUDIT_EVENT_TYPES, STANDING_PROVENANCES, isConfirmationRecord, isIntentRecord, isStandingInstruction, validateConfidenceFloor, validateConfirmationRecord, validateConfirmationRecords, validateInstructionUsages, validateIntentRecord, validateIntentRecords, validatePolicyVersion, validatePreferencePaths, validateStandingInstruction, validateStandingInstructions, } from "./schema.js";
 export { checkConfirmationCompleteness, checkCurrency, checkWithdrawalParity, decideStandingChange, evaluateStandingInstruction, recordReopened, recordStaleness, } from "./contract.js";
+export { assessConfirmedCurrentIntentRate } from "./confirmed-current-intent-rate.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAyBrB,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAyBrB,OAAO,EACL,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/schema.d.ts

@@ -41,11 +41,11 @@
  * carries nothing else.
  *
  * Validation here is hand-rolled over `unknown`, with no schema library,
- * matching every other package in this workspace (see the root
- * `AGENTS.md`). These validators exist for the boundary where records
- * arrive as untyped JSON — a preference-centre route body, a file the CLI
- * reads, a value read back out of a host's own store — before anything
- * downstream is allowed to trust them.
+ * matching every other package in this workspace. These validators exist
+ * for the boundary where records arrive as untyped JSON — a
+ * preference-centre route body, a file the CLI reads, a value read back out
+ * of a host's own store — before anything downstream is allowed to trust
+ * them.
  */
 import { type ValidationResult } from "./validation.js";
 /**

package/dist/schema.js

@@ -41,11 +41,11 @@
  * carries nothing else.
  *
  * Validation here is hand-rolled over `unknown`, with no schema library,
- * matching every other package in this workspace (see the root
- * `AGENTS.md`). These validators exist for the boundary where records
- * arrive as untyped JSON — a preference-centre route body, a file the CLI
- * reads, a value read back out of a host's own store — before anything
- * downstream is allowed to trust them.
+ * matching every other package in this workspace. These validators exist
+ * for the boundary where records arrive as untyped JSON — a
+ * preference-centre route body, a file the CLI reads, a value read back out
+ * of a host's own store — before anything downstream is allowed to trust
+ * them.
  */
 import { isOneOf, isPlainObject, pushIssue, optionalTimestamp, requireArrayOf, requireBoolean, requireNumber, requireString, requireTimestamp, } from "./validation.js";
 /** Every provenance value, for a caller validating untyped input. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clossys/butler",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -22,7 +22,8 @@
     }
   },
   "bin": {
-    "butler-check": "dist/cli.js"
+    "butler-check": "dist/cli.js",
+    "butler-rate-check": "dist/confirmed-current-intent-rate-cli.js"
   },
   "files": [
     "dist",
@@ -33,6 +34,12 @@
     "LICENSE"
   ],
   "sideEffects": false,
+  "foundry": {
+    "assessment": {
+      "bin": "butler-rate-check",
+      "invocation": "single-json-input"
+    }
+  },
   "description": "The butler role: do we have what this person wants — this request in their own confirmation, and their standing instructions, still current? Dependency-free machinery for a consumer's own want records: a three-state standing model (absent/denied/granted) plus a stale evaluation status, structured intents carrying a confidence read against a declared floor, host-supplied storage and audit ports, an isolated ./inbound admission subpath, an optional ./web subpath whose React peer is asserted at import time, and three gates behind one butler-check bin — confirmation-completeness, which fails when an acted-on intent has no confirmation record, when it was acted on against a misread or unclear read-back, or when an intent below the declared confidence floor was acted on with no explicit hand-off; currency, which fails when a standing instruction is relied on past its declared window, after a policy version superseded it, or when nothing was on record to rely on at all; and withdrawal-parity, which fails when withdrawing takes more steps than granting or demands a contact or an account the matching grant path never required. Ships the schema and the checkers; every consumer authors its own values.",
   "keywords": [
     "butler",

package/src/confirmed-current-intent-rate-cli.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessConfirmedCurrentIntentRate } from "./confirmed-current-intent-rate.js";
+
+const USAGE = `Usage: butler-rate-check <assessment.json>\n\nAssess confirmed current intent rate from consumer-supplied independent observations.\nExit codes: 0 = satisfied, 1 = violated, 2 = indeterminate or unreadable.\nbutler-check remains the three-gate CLI and is not this assessment.`;
+
+export class ButlerRateCliInputError extends Error {}
+
+/** Reads caller-owned assessment evidence without treating it as validated. */
+export function readButlerAssessmentJson(path: string): unknown {
+  const resolved = resolve(path);
+  if (!existsSync(resolved)) throw new ButlerRateCliInputError(`assessment file "${path}" does not exist`);
+  try {
+    if (!statSync(resolved).isFile()) throw new ButlerRateCliInputError(`assessment file "${path}" is not a file`);
+    return JSON.parse(readFileSync(resolved, "utf8"));
+  } catch (cause) {
+    if (cause instanceof ButlerRateCliInputError) throw cause;
+    throw new ButlerRateCliInputError(`assessment file "${path}" is unreadable JSON: ${cause instanceof Error ? cause.message : String(cause)}`);
+  }
+}
+
+/** Testable CLI dispatcher. Invalid arguments throw; the executable maps them to exit 2. */
+export function main(argv: readonly string[]): number {
+  if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+    console.log(USAGE);
+    return 0;
+  }
+  if (argv.length !== 1) throw new ButlerRateCliInputError("exactly one assessment.json file is required");
+  const report = assessConfirmedCurrentIntentRate(readButlerAssessmentJson(argv[0] as string));
+  console.log(JSON.stringify(report, null, 2));
+  return report.state === "satisfied" ? 0 : report.state === "violated" ? 1 : 2;
+}
+
+function run(): void {
+  try {
+    process.exitCode = main(process.argv.slice(2));
+  } catch (cause) {
+    console.error(`butler-rate-check: ${cause instanceof Error ? cause.message : String(cause)}`);
+    process.exitCode = 2;
+  }
+}
+
+/** Resolves an npm/POSIX bin symlink before deciding whether this module is the entrypoint. */
+export function isDirectInvocation(moduleUrl: string, argvPath: string | undefined): boolean {
+  if (argvPath === undefined) return false;
+  try {
+    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(resolve(argvPath));
+  } catch {
+    return false;
+  }
+}
+
+if (isDirectInvocation(import.meta.url, process.argv[1])) run();

package/src/confirmed-current-intent-rate.ts

@@ -0,0 +1,192 @@
+/**
+ * Computes the Butler charter metric `confirmed current intent rate` from
+ * consumer-supplied independent observations.
+ *
+ * This module does not invent observations and does not relabel
+ * `checkConfirmationCompleteness` or `checkCurrency`. An empty evaluated
+ * set is indeterminate, never a perfect rate of 1. Withdrawal-parity is
+ * not this rate.
+ */
+const METRIC = "confirmed current intent rate" as const;
+const RESERVED_OBSERVERS = new Set(["butler", "@clossys/butler"]);
+const PROPOSED_POSITIONS: readonly unknown[] = [];
+const KINDS = new Set(["acted-request", "standing-instruction-use"]);
+
+export type ConfirmedCurrentIntentRateState = "satisfied" | "violated" | "indeterminate";
+
+export interface ConfirmedCurrentIntentRateFinding {
+  readonly rule: string;
+  readonly severity: "error";
+  readonly message: string;
+  readonly path?: string;
+}
+
+export interface ConfirmedCurrentIntentRateAssessment {
+  readonly metric: "confirmed current intent rate";
+  readonly state: ConfirmedCurrentIntentRateState;
+  readonly rate: number | null;
+  readonly evaluatedIntents: number;
+  readonly confirmedCurrentIntents: number;
+  readonly findings: readonly ConfirmedCurrentIntentRateFinding[];
+  readonly proposedPositions: readonly unknown[];
+}
+
+type UnknownRecord = Record<string, unknown>;
+
+function record(value: unknown): value is UnknownRecord {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function text(value: unknown): value is string {
+  return typeof value === "string" && value.trim().length > 0;
+}
+
+function timestamp(value: unknown): value is string {
+  return text(value) && !Number.isNaN(Date.parse(value));
+}
+
+function finding(rule: string, message: string, path?: string): ConfirmedCurrentIntentRateFinding {
+  return path === undefined ? { rule, severity: "error", message } : { rule, severity: "error", message, path };
+}
+
+function evidenceCounts(value: unknown): boolean {
+  if (!Array.isArray(value) || value.length === 0) return false;
+  return value.every((item) => record(item) && text(item.id) && text(item.description));
+}
+
+function reservedObserver(value: string): boolean {
+  return RESERVED_OBSERVERS.has(value.trim().toLowerCase());
+}
+
+function report(
+  state: ConfirmedCurrentIntentRateState,
+  evaluatedIntents: number,
+  confirmedCurrentIntents: number,
+  rate: number | null,
+  findings: readonly ConfirmedCurrentIntentRateFinding[],
+): ConfirmedCurrentIntentRateAssessment {
+  return {
+    metric: METRIC,
+    state,
+    rate,
+    evaluatedIntents,
+    confirmedCurrentIntents,
+    findings,
+    proposedPositions: PROPOSED_POSITIONS,
+  };
+}
+
+interface CountingObservation {
+  readonly confirmed: boolean;
+  readonly current: boolean;
+}
+
+function isConfirmedCurrent(entry: CountingObservation): boolean {
+  return entry.confirmed && entry.current;
+}
+
+/**
+ * Computes `confirmed current intent rate`: evaluated acted requests and
+ * standing-instruction uses backed by current subject confirmation / all
+ * acted requests and standing-instruction uses evaluated.
+ */
+export function assessConfirmedCurrentIntentRate(input: unknown): ConfirmedCurrentIntentRateAssessment {
+  if (!record(input)) {
+    return report("indeterminate", 0, 0, null, [finding("assessment-shape", "Assessment input must be an object.", "$")]);
+  }
+
+  const findings: ConfirmedCurrentIntentRateFinding[] = [];
+  if (!timestamp(input.asOf)) {
+    findings.push(finding("assessment-as-of", "asOf must be an interpretable timestamp.", "asOf"));
+  }
+
+  const declaredIntents = input.declaredIntents;
+  if (!Array.isArray(declaredIntents)) {
+    findings.push(finding("declared-intents-required", "declaredIntents must be an array of { id, kind } objects.", "declaredIntents"));
+    return report("indeterminate", 0, 0, null, findings);
+  }
+
+  const declaredIds: string[] = [];
+  const declaredSet = new Set<string>();
+  declaredIntents.forEach((item, index) => {
+    const path = `declaredIntents[${index}]`;
+    if (!record(item) || !text(item.id)) {
+      findings.push(finding("intent-id-required", "id must be a non-empty string.", `${path}.id`));
+      return;
+    }
+    if (!text(item.kind) || !KINDS.has(item.kind)) {
+      findings.push(finding("intent-kind-required", 'kind must be "acted-request" or "standing-instruction-use".', `${path}.kind`));
+      return;
+    }
+    if (declaredSet.has(item.id)) {
+      findings.push(finding("duplicate-intent-id", `Duplicate id "${item.id}".`, `${path}.id`));
+      return;
+    }
+    declaredSet.add(item.id);
+    declaredIds.push(item.id);
+  });
+
+  if (declaredIds.length === 0) {
+    findings.push(finding("declared-intents-empty", "No declared intents are available for the confirmed-current-intent metric; the rate is indeterminate, never 1.", "declaredIntents"));
+  }
+
+  const observations = input.observations;
+  if (observations !== undefined && !Array.isArray(observations)) {
+    findings.push(finding("observations-shape", "observations must be an array.", "observations"));
+  }
+
+  const counting = new Map<string, CountingObservation[]>();
+  if (Array.isArray(observations)) {
+    observations.forEach((item, index) => {
+      const path = `observations[${index}]`;
+      if (!record(item)) {
+        findings.push(finding("observation-shape", "An observation must be an object.", path));
+        return;
+      }
+      if (text(item.observerRef) && reservedObserver(item.observerRef)) {
+        findings.push(finding("self-observation", "Butler cannot observe itself; reserved observerRef values are not independent.", `${path}.observerRef`));
+        return;
+      }
+      if (text(item.intentId) && !declaredSet.has(item.intentId)) {
+        findings.push(finding("unknown-intent", `Observation intentId "${item.intentId}" is not a declared intent.`, `${path}.intentId`));
+        return;
+      }
+      if (item.independent !== true) return;
+      if (typeof item.confirmed !== "boolean" || typeof item.current !== "boolean") return;
+      if (!text(item.observerRef) || !evidenceCounts(item.evidence) || !text(item.intentId) || !declaredSet.has(item.intentId)) return;
+      const bucket = counting.get(item.intentId) ?? [];
+      bucket.push({ confirmed: item.confirmed, current: item.current });
+      counting.set(item.intentId, bucket);
+    });
+  }
+
+  let evaluatedIntents = 0;
+  let confirmedCurrentIntents = 0;
+  for (const id of declaredIds) {
+    const observed = counting.get(id) ?? [];
+    if (observed.length === 0) {
+      findings.push(finding("intent-unevaluated", `Declared intent "${id}" has no counting independent observation.`, `declaredIntents.${id}`));
+      continue;
+    }
+    evaluatedIntents += 1;
+    const allConfirmedCurrent = observed.every((entry) => isConfirmedCurrent(entry));
+    if (allConfirmedCurrent) confirmedCurrentIntents += 1;
+    else {
+      findings.push(finding("intent-not-confirmed-current", `Declared intent "${id}" was independently observed without current subject confirmation.`, `declaredIntents.${id}`));
+    }
+    if (observed.length > 1) {
+      const first = observed[0]!;
+      if (observed.some((entry) => entry.confirmed !== first.confirmed || entry.current !== first.current)) {
+        findings.push(finding("observation-disagreement", `Counting observations for "${id}" disagree.`, `observations.${id}`));
+      }
+    }
+  }
+
+  const rate = evaluatedIntents === 0 ? null : confirmedCurrentIntents / evaluatedIntents;
+  if (evaluatedIntents === 0) return report("indeterminate", 0, 0, null, findings);
+  const coverageComplete = evaluatedIntents === declaredIds.length;
+  const noErrorFindings = findings.length === 0;
+  const state: ConfirmedCurrentIntentRateState =
+    coverageComplete && confirmedCurrentIntents === evaluatedIntents && noErrorFindings ? "satisfied" : "violated";
+  return report(state, evaluatedIntents, confirmedCurrentIntents, rate, findings);
+}

package/src/index.ts

@@ -29,7 +29,11 @@
  *      `checkCurrency`, and `checkWithdrawalParity`. Each is a pure
  *      function returning a three-state result, and `cli.ts` folds those
  *      onto the `0`/`1`/`2` exit contract without ever collapsing "could
- *      not run" into either "clean" or "findings".
+ *      not run" into either "clean" or "findings". The charter metric
+ *      `confirmed current intent rate` is computed by
+ *      `assessConfirmedCurrentIntentRate` from consumer-supplied
+ *      independent observations and is not either gate. `butler-rate-check`
+ *      is the assessment surface; `butler-check` remains the three-gate CLI.
  *
  * Two subpaths sit beside this one. `./inbound` is admission — whether an
  * event arriving on a channel should be acknowledged and processed at all,
@@ -95,6 +99,12 @@ export {
   recordReopened,
   recordStaleness,
 } from "./contract.js";
+export { assessConfirmedCurrentIntentRate } from "./confirmed-current-intent-rate.js";
+export type {
+  ConfirmedCurrentIntentRateAssessment,
+  ConfirmedCurrentIntentRateFinding,
+  ConfirmedCurrentIntentRateState,
+} from "./confirmed-current-intent-rate.js";
 export type {
   ConfirmationCompletenessResult,
   ConfirmationFailureReason,

package/src/schema.ts

@@ -41,11 +41,11 @@
  * carries nothing else.
  *
  * Validation here is hand-rolled over `unknown`, with no schema library,
- * matching every other package in this workspace (see the root
- * `AGENTS.md`). These validators exist for the boundary where records
- * arrive as untyped JSON — a preference-centre route body, a file the CLI
- * reads, a value read back out of a host's own store — before anything
- * downstream is allowed to trust them.
+ * matching every other package in this workspace. These validators exist
+ * for the boundary where records arrive as untyped JSON — a
+ * preference-centre route body, a file the CLI reads, a value read back out
+ * of a host's own store — before anything downstream is allowed to trust
+ * them.
  */
 
 import {