@aragon-agent/cli 0.6.47 → 0.6.48

package/dist/fast/types.d.ts

@@ -1,141 +0,0 @@
-/**
- * Runtime shapes for the fast tier (fast-model-tier §5.2 / §5.3).
- *
- * ASCII ONLY: `src/fast/**` is inside the glyph scanner's scope.
- *
- * `FastEvent` is a CLI-LOCAL stream and must stay that way (D-10 / I-1), for
- * the reason `TeamEvent` and `TodoEvent` each record: `packages/core` freezes
- * its runtime export list (`public-api.test.ts`) and forbids host coupling
- * (`no-host-coupling.test.ts`), so a new member of core's `AgentEvent` union
- * would break the first and teach core about a host shape it has no business
- * defining. This whole feature therefore changes ZERO files under
- * `packages/core/` (AC-30).
- */
-import type { ModelRef, ThinkingLevel, TokenUsage } from '@aragon-agent/core';
-/** Which model runs a piece of work. Two tiers, and deliberately not three. */
-export type FastTierName = 'main' | 'fast';
-/**
- * The resolved fast tier, or the reason there isn't one.
- *
- * A DISCRIMINATED UNION rather than a nullable `ModelRef`, because every UI
- * surface has to be able to say WHY the tier is off: "enabled but no model" and
- * "enabled but no key for openai" send the user to two different settings.
- */
-export type FastTier = {
-    ok: true;
-    ref: ModelRef;
-    thinkingLevel: ThinkingLevel;
-    sameAsMain: boolean;
-} | {
-    ok: false;
-    reason: FastTierOffReason;
-};
-export type FastTierOffReason = 'disabled' | 'no_model' | 'no_adapter' | 'no_key';
-/**
- * One completed turn of the lead, as the reviewer records it.
- *
- * `sealed` is what §3.5.1 turns on: a frame is complete only once every
- * `tool_execution_end` of its batch has landed, because `isError` and `ms` do
- * not exist before then (`agent-loop.ts:249-256`). A digest built from an
- * unsealed frame is structurally missing the single fact a reviewer most needs -
- * whether the batch it is reviewing just failed (RV-2 / D-22).
- */
-export interface TurnFrame {
-    /** 1-based within the run. */
-    index: number;
-    /** <= FAST_LIMITS.turnTailChars, appended and clipped per `text_delta`. */
-    textTail: string;
-    tools: Array<{
-        name: string;
-        arg?: string;
-        isError?: boolean;
-        ms?: number;
-    }>;
-    /** `formatStreamError` output, when the turn errored. */
-    error?: string;
-    /** Complete, and safe to digest (§3.5.1). */
-    sealed: boolean;
-}
-/** One review, in whatever state it reached. Rendered by `FastCard`. */
-export interface FastReview {
-    /** 1-based within the SESSION, so `/fast status` can count them. */
-    index: number;
-    runId: number;
-    /** The turn that triggered it. */
-    turn: number;
-    /** The resolved fast model id, for the card and the injected wrapper. */
-    model: string;
-    kind: 'ok' | 'advice' | 'empty' | 'failed' | 'dropped';
-    /** Present only for `advice`. */
-    text?: string;
-    /** Failure reason / drop reason. */
-    detail?: string;
-    durationMs: number;
-    usage?: TokenUsage;
-    injected: boolean;
-}
-/** Everything `/fast status`, the chip and the settings line read. */
-export interface FastSnapshot {
-    /** The tier resolved AND the live switch is on. */
-    live: boolean;
-    /**
-     * The reviewer switched ITSELF off after `maxConsecutiveFailures` in a row
-     * (`FastReviewer.onReviewFailure`).
-     *
-     * ORTHOGONAL TO `live`, AND NEITHER IMPLIES THE OTHER. `live` answers "did
-     * this tier resolve at all" and is `registered && enabled && tier.ok`; the
-     * self-disable touches none of those three, so `live` stays `true` after it.
-     * A consumer that wants to report "the fast reviews stopped happening" MUST
-     * read this field: deriving it as `live === false` is a predicate that can
-     * never be true, and a hand-written fixture makes its test green for ever.
-     *
-     * `available()` is deliberately NOT widened to include it — see the note on
-     * `FastWiring.available`.
-     */
-    selfDisabled: boolean;
-    model: string;
-    sameAsMain: boolean;
-    reviews: number;
-    /** The live session budget, for the `n/N` render (fast-model-tier-hardening
-     *  §5). Read in the SAME expression as `reviews`, so the numerator and the
-     *  denominator cannot describe different moments. */
-    reviewBudget: number;
-    /**
-     * Whether the session budget is exhausted. CARRIED, NOT DERIVED: callers MUST
-     * NOT recompute `reviews >= reviewBudget`. In `offFastStatus()` both numbers
-     * are `0` placeholders for "there is no tier", and that comparison would
-     * report a budget reached for a session that never had one (RV-H10).
-     */
-    budgetReached: boolean;
-    usage: TokenUsage;
-    /**
-     * No price table for `model` (C-11 / RV-4).
-     *
-     * `ModelRegistry.buildRuntimeModel` returns `cost: { input: 0, output: 0 }`
-     * for a model the static table has never seen, and the fast tier is precisely
-     * where an unrecognised id is LIKELY. Rendering that as `$0.00` would make the
-     * feature look free while it is spending money.
-     */
-    pricingUnknown: boolean;
-    /** A review call is open right now. */
-    inFlight: boolean;
-}
-/**
- * The CLI-local event stream. `FastReviewer` emits; `FastWiring` forwards;
- * `AgentController.subscribeFast` exposes; `App` and `runHeadless` consume.
- */
-export type FastEvent = {
-    type: 'review_start';
-    index: number;
-    turn: number;
-} | {
-    type: 'review_end';
-    review: FastReview;
-} | {
-    type: 'usage';
-    usage: TokenUsage;
-} | {
-    type: 'tier_changed';
-    snapshot: FastSnapshot;
-};
-export type FastEventListener = (event: FastEvent) => void;

package/dist/fast/types.js

@@ -1,14 +0,0 @@
-/**
- * Runtime shapes for the fast tier (fast-model-tier §5.2 / §5.3).
- *
- * ASCII ONLY: `src/fast/**` is inside the glyph scanner's scope.
- *
- * `FastEvent` is a CLI-LOCAL stream and must stay that way (D-10 / I-1), for
- * the reason `TeamEvent` and `TodoEvent` each record: `packages/core` freezes
- * its runtime export list (`public-api.test.ts`) and forbids host coupling
- * (`no-host-coupling.test.ts`), so a new member of core's `AgentEvent` union
- * would break the first and teach core about a host shape it has no business
- * defining. This whole feature therefore changes ZERO files under
- * `packages/core/` (AC-30).
- */
-export {};

package/dist/governance/governed-dispatch.d.ts

@@ -1,19 +0,0 @@
-/**
- * `isGovernedDispatch` - the one predicate that says whether a team dispatch belongs to a
- * governed run (governance-mode section 10.4, RV-3).
- *
- * Pure: no React, no I/O. ASCII ONLY (`governance/` is glyph-scanned).
- *
- * WHY A FUNCTION AND NOT AN INLINE FIELD CHECK. The reducer's `teamStart` must keep a
- * governed dispatch out of the transcript (one run is 10-20 dispatches; a `TeamCard` for
- * each would bury the conversation) while writing the live `state.team` snapshot the
- * panel and `/agents` read. Two call sites need the same answer (the reducer and, later,
- * the card tests), and "does any spec carry governance" is exactly the kind of check that
- * grows a second spelling. The reducer imports ONLY this function.
- */
-/** The structural slice of a `SubagentSpec` this predicate reads. */
-export interface GovernedSpecLike {
-    governance?: unknown;
-}
-/** True when ANY spec of the dispatch is governed (a governed stage is homogeneous). */
-export declare function isGovernedDispatch(specs: readonly GovernedSpecLike[]): boolean;

package/dist/governance/governed-dispatch.js

@@ -1,17 +0,0 @@
-/**
- * `isGovernedDispatch` - the one predicate that says whether a team dispatch belongs to a
- * governed run (governance-mode section 10.4, RV-3).
- *
- * Pure: no React, no I/O. ASCII ONLY (`governance/` is glyph-scanned).
- *
- * WHY A FUNCTION AND NOT AN INLINE FIELD CHECK. The reducer's `teamStart` must keep a
- * governed dispatch out of the transcript (one run is 10-20 dispatches; a `TeamCard` for
- * each would bury the conversation) while writing the live `state.team` snapshot the
- * panel and `/agents` read. Two call sites need the same answer (the reducer and, later,
- * the card tests), and "does any spec carry governance" is exactly the kind of check that
- * grows a second spelling. The reducer imports ONLY this function.
- */
-/** True when ANY spec of the dispatch is governed (a governed stage is homogeneous). */
-export function isGovernedDispatch(specs) {
-    return specs.some((spec) => spec.governance !== undefined);
-}

package/dist/governance/limits.d.ts

@@ -1,107 +0,0 @@
-/**
- * GOV_LIMITS - the single authority on every STRUCTURAL bound governance enforces
- * (governance-mode section 8.5), plus the stable tool-name sets and block versions.
- *
- * ASCII ONLY: `src/governance/**` is inside the glyph scanner's scope
- * (`glyphs.test.ts::inScope`, D-18).
- *
- * TWO KINDS OF NUMBER, exactly like `team/limits.ts`: the entries here are STRUCTURAL
- * (what the store, the digest and the panel can physically carry; a user has no
- * business tuning them) while the `governance.*` config keys (`config/schema.ts`) are
- * POLICY and clamped. `hardMax*` bound a config key and are applied twice: once in
- * `clampGovernanceConfig` and once in the engine, because a clamp that only runs on the
- * read path leaves a bad value on disk.
- */
-export declare const GOV_LIMITS: {
-    /** Ceiling for `governance.maxWorkPackages`. */
-    readonly hardMaxWorkPackages: 8;
-    /** Ceiling for `governance.maxPhases`. */
-    readonly hardMaxPhases: 6;
-    /** Ceiling for `governance.maxRework`, INCLUDING L3 `retry` grants. */
-    readonly hardMaxRework: 5;
-    /** Ceiling for `governance.maxFixCycles`, INCLUDING L3 `retry` grants. */
-    readonly hardMaxFixCycles: 5;
-    /** `gov_dispatch` calls per run. */
-    readonly hardMaxDispatches: 120;
-    /** At most this many `retry` grants per WP (resolve.disposition). */
-    readonly maxReworkGrantsPerWp: 2;
-    /** At most this many extra fix cycles may be granted per phase. */
-    readonly maxFixGrantsPerPhase: 1;
-    readonly goalChars: 300;
-    readonly specChars: 12000;
-    readonly wpIdChars: 16;
-    readonly wpTitleChars: 80;
-    readonly wpGoalChars: 1200;
-    readonly wpFilesMax: 12;
-    readonly wpAcceptanceMax: 8;
-    readonly wpAcceptanceChars: 200;
-    readonly contractsMax: 12;
-    readonly contractNameChars: 80;
-    readonly contractDefinitionChars: 800;
-    readonly integrationCommandsMax: 6;
-    readonly integrationCommandChars: 300;
-    readonly noteChars: 600;
-    readonly rulingChars: 1000;
-    readonly reasonChars: 300;
-    /** `ledger_apply` evidence must carry at least this many characters (D-4). */
-    readonly evidenceMinChars: 20;
-    readonly evidenceMaxChars: 1200;
-    readonly submissionBytes: 64000;
-    readonly artifactBytesPerRun: 20000000;
-    readonly eventsFileBytes: 8000000;
-    readonly historyPerAgent: 200;
-    readonly retentionDays: 30;
-    readonly pruneMaxPerPass: 200;
-    /** Heartbeat of `run.lock` while a stage runs. */
-    readonly lockHeartbeatMs: 15000;
-    /** A lock whose heartbeat is older than this is stale and may be taken over. */
-    readonly lockStaleMs: 60000;
-    readonly digestMaxBytes: 6000;
-    readonly finalReportMaxBytes: 24000;
-    /** Spec excerpt budget inside a child prompt. */
-    readonly specExcerptChars: 2000;
-    readonly initialTokens: 100;
-    readonly respawnTokens: 80;
-    readonly maxSingleReward: 20;
-    readonly maxSingleDeduction: -40;
-    readonly maxIncidentNegative: -50;
-    readonly tailEliminationThreshold: 60;
-    readonly healthWarnThreshold: 70;
-    readonly labelWarnThreshold: 80;
-    readonly labelDangerThreshold: 60;
-    /** Active members of a role needed before tail elimination is considered. */
-    readonly tailEliminationMinRoleSize: 3;
-    /** A child may fail validation this many times before the submission counts as absent. */
-    readonly maxValidationFailures: 3;
-    /** Dispatch retries for a child that finished without a required submission. */
-    readonly maxAutoRedispatch: 1;
-    /** `gov_view` requests per child, and the minimum reason length. */
-    readonly viewRequestsPerChild: 1;
-    readonly viewReasonMinChars: 20;
-    /** `gov_scan` path cap. */
-    readonly scanPathsMax: 40;
-    /** `gov_read` page size in characters. */
-    readonly readPageChars: 6000;
-    /** Budget warning fraction (>= this share of `budgetTokens`). */
-    readonly budgetWarnFraction: 0.8;
-    /** `skeletonRatio` above this converts D9 into D11. */
-    readonly skeletonRatioThreshold: 0.3;
-};
-/** Version of the schema written to `run.json` / `ledger.json`. */
-export declare const GOV_SCHEMA_VERSION = 1;
-/** Block versions: bump on ANY wording change so behavior reports can grep for them. */
-export declare const GOVERNANCE_BLOCK_VERSION = "v1-2026-10-24";
-export declare const GOVERNANCE_ROLE_BLOCK_VERSION = "v1-2026-10-24";
-export declare const GOVERNANCE_PLAN_ADDENDUM_VERSION = "v1-2026-10-24";
-/** The two tools registered into the lead's array (NOT in HOST_TOOL_NAMES, D-22b). */
-export declare const GOV_LEAD_TOOL_NAMES: ReadonlySet<string>;
-/** Every tool a governed child may be handed. Merged into `policyExempt` (7.1 rule 6). */
-export declare const GOV_CHILD_TOOL_NAMES: ReadonlySet<string>;
-/**
- * The lead tools a governed ORCHESTRATOR may not call: the plan-mode blocked set plus
- * `task` (the latter only while the gate mode is `build`). Kept as a literal list so a
- * future change to `PLAN_MODE_BLOCKED_TOOLS` is a deliberate edit, not an accident.
- */
-export declare const GOVERN_ORCHESTRATOR_REFUSED_TOOLS: readonly string[];
-/** Run directory id: "g" + base36(timeMs) + 3 random [a-z0-9]. */
-export declare const RUN_ID_PATTERN: RegExp;

package/dist/governance/limits.js

@@ -1,131 +0,0 @@
-/**
- * GOV_LIMITS - the single authority on every STRUCTURAL bound governance enforces
- * (governance-mode section 8.5), plus the stable tool-name sets and block versions.
- *
- * ASCII ONLY: `src/governance/**` is inside the glyph scanner's scope
- * (`glyphs.test.ts::inScope`, D-18).
- *
- * TWO KINDS OF NUMBER, exactly like `team/limits.ts`: the entries here are STRUCTURAL
- * (what the store, the digest and the panel can physically carry; a user has no
- * business tuning them) while the `governance.*` config keys (`config/schema.ts`) are
- * POLICY and clamped. `hardMax*` bound a config key and are applied twice: once in
- * `clampGovernanceConfig` and once in the engine, because a clamp that only runs on the
- * read path leaves a bad value on disk.
- */
-export const GOV_LIMITS = {
-    /** Ceiling for `governance.maxWorkPackages`. */
-    hardMaxWorkPackages: 8,
-    /** Ceiling for `governance.maxPhases`. */
-    hardMaxPhases: 6,
-    /** Ceiling for `governance.maxRework`, INCLUDING L3 `retry` grants. */
-    hardMaxRework: 5,
-    /** Ceiling for `governance.maxFixCycles`, INCLUDING L3 `retry` grants. */
-    hardMaxFixCycles: 5,
-    /** `gov_dispatch` calls per run. */
-    hardMaxDispatches: 120,
-    /** At most this many `retry` grants per WP (resolve.disposition). */
-    maxReworkGrantsPerWp: 2,
-    /** At most this many extra fix cycles may be granted per phase. */
-    maxFixGrantsPerPhase: 1,
-    // --- Input sizes (tool arguments) ---
-    goalChars: 300,
-    specChars: 12_000,
-    wpIdChars: 16,
-    wpTitleChars: 80,
-    wpGoalChars: 1_200,
-    wpFilesMax: 12,
-    wpAcceptanceMax: 8,
-    wpAcceptanceChars: 200,
-    contractsMax: 12,
-    contractNameChars: 80,
-    contractDefinitionChars: 800,
-    integrationCommandsMax: 6,
-    integrationCommandChars: 300,
-    noteChars: 600,
-    rulingChars: 1_000,
-    reasonChars: 300,
-    /** `ledger_apply` evidence must carry at least this many characters (D-4). */
-    evidenceMinChars: 20,
-    evidenceMaxChars: 1_200,
-    // --- Storage ---
-    submissionBytes: 64_000,
-    artifactBytesPerRun: 20_000_000,
-    eventsFileBytes: 8_000_000,
-    historyPerAgent: 200,
-    retentionDays: 30,
-    pruneMaxPerPass: 200,
-    /** Heartbeat of `run.lock` while a stage runs. */
-    lockHeartbeatMs: 15_000,
-    /** A lock whose heartbeat is older than this is stale and may be taken over. */
-    lockStaleMs: 60_000,
-    // --- Reports ---
-    digestMaxBytes: 6_000,
-    finalReportMaxBytes: 24_000,
-    /** Spec excerpt budget inside a child prompt. */
-    specExcerptChars: 2_000,
-    // --- Ledger parameters (Appendix A fixed parameters) ---
-    initialTokens: 100,
-    respawnTokens: 80,
-    maxSingleReward: 20,
-    maxSingleDeduction: -40,
-    maxIncidentNegative: -50,
-    tailEliminationThreshold: 60,
-    healthWarnThreshold: 70,
-    labelWarnThreshold: 80,
-    labelDangerThreshold: 60,
-    /** Active members of a role needed before tail elimination is considered. */
-    tailEliminationMinRoleSize: 3,
-    // --- Validation ---
-    /** A child may fail validation this many times before the submission counts as absent. */
-    maxValidationFailures: 3,
-    /** Dispatch retries for a child that finished without a required submission. */
-    maxAutoRedispatch: 1,
-    /** `gov_view` requests per child, and the minimum reason length. */
-    viewRequestsPerChild: 1,
-    viewReasonMinChars: 20,
-    /** `gov_scan` path cap. */
-    scanPathsMax: 40,
-    /** `gov_read` page size in characters. */
-    readPageChars: 6_000,
-    /** Budget warning fraction (>= this share of `budgetTokens`). */
-    budgetWarnFraction: 0.8,
-    /** `skeletonRatio` above this converts D9 into D11. */
-    skeletonRatioThreshold: 0.3,
-};
-/** Version of the schema written to `run.json` / `ledger.json`. */
-export const GOV_SCHEMA_VERSION = 1;
-/** Block versions: bump on ANY wording change so behavior reports can grep for them. */
-export const GOVERNANCE_BLOCK_VERSION = 'v1-2026-10-24';
-export const GOVERNANCE_ROLE_BLOCK_VERSION = 'v1-2026-10-24';
-export const GOVERNANCE_PLAN_ADDENDUM_VERSION = 'v1-2026-10-24';
-/** The two tools registered into the lead's array (NOT in HOST_TOOL_NAMES, D-22b). */
-export const GOV_LEAD_TOOL_NAMES = new Set(['gov_run', 'gov_dispatch']);
-/** Every tool a governed child may be handed. Merged into `policyExempt` (7.1 rule 6). */
-export const GOV_CHILD_TOOL_NAMES = new Set([
-    'gov_submit_work',
-    'gov_submit_review',
-    'gov_submit_test',
-    'ledger_standings',
-    'gov_read',
-    'gov_scan',
-    'gov_view',
-    'ledger_apply',
-    'ledger_rule',
-    'ledger_settle',
-]);
-/**
- * The lead tools a governed ORCHESTRATOR may not call: the plan-mode blocked set plus
- * `task` (the latter only while the gate mode is `build`). Kept as a literal list so a
- * future change to `PLAN_MODE_BLOCKED_TOOLS` is a deliberate edit, not an accident.
- */
-export const GOVERN_ORCHESTRATOR_REFUSED_TOOLS = [
-    'write_file',
-    'edit_file',
-    'bash',
-    'bash_kill',
-    'skill_install',
-    'skill_create',
-    'task',
-];
-/** Run directory id: "g" + base36(timeMs) + 3 random [a-z0-9]. */
-export const RUN_ID_PATTERN = /^g[a-z0-9]{4,12}$/;

package/dist/governance/posture.d.ts

@@ -1,35 +0,0 @@
-/**
- * Posture - the user-visible composite of (gate mode, governance on)
- * (governance-mode section 4.1).
- *
- * Pure: no React, no I/O, no `node:*`. ASCII ONLY (`governance/` is glyph-scanned).
- *
- * WHY A COMPOSITE AND NOT A THIRD/FOURTH `AgentMode` (D-1). `AgentMode` is
- * `'build' | 'plan'` and 25+ sites key off that pair (`=== 'plan'`,
- * `Record<AgentMode, ...>`, the plan gate, the subagent `getMode`). Widening it needs a
- * silent-failure audit of every one of them (a miss means "writable when it should be
- * read-only"). Two orthogonal dimensions leave every existing path untouched.
- */
-import type { AgentMode } from '../agent/agent-mode.js';
-export type Posture = 'build' | 'plan' | 'govern' | 'plan_govern';
-/** Full Shift+Tab cycle: BUILD -> PLAN -> GOVERN -> PLAN+GOVERN -> BUILD. */
-export declare const POSTURES_FULL: readonly Posture[];
-/** The classic two-state cycle, used whenever governance is unavailable or switched off. */
-export declare const POSTURES_CLASSIC: readonly Posture[];
-export declare const POSTURE_LABEL: Record<Posture, string>;
-/** Lower-case spelling for the `shift+tab <next>` hint clause. */
-export declare function postureHintWord(posture: Posture): string;
-/** (gate mode, governance on) -> posture. Exhaustive; the one place the mapping lives. */
-export declare function composePosture(mode: AgentMode, governanceOn: boolean): Posture;
-/** posture -> (gate mode, governance on). Inverse of `composePosture`. */
-export declare function splitPosture(posture: Posture): {
-    mode: AgentMode;
-    governance: boolean;
-};
-/** True when the posture has governance switched on. */
-export declare function isGovernancePosture(posture: Posture): boolean;
-/**
- * The next posture in `cycle`. A `current` outside the cycle (e.g. `govern` while the
- * cycle is classic) advances to `'build'` - never throws, never loops on itself.
- */
-export declare function nextPosture(current: Posture, cycle: readonly Posture[]): Posture;

package/dist/governance/posture.js

@@ -1,59 +0,0 @@
-/**
- * Posture - the user-visible composite of (gate mode, governance on)
- * (governance-mode section 4.1).
- *
- * Pure: no React, no I/O, no `node:*`. ASCII ONLY (`governance/` is glyph-scanned).
- *
- * WHY A COMPOSITE AND NOT A THIRD/FOURTH `AgentMode` (D-1). `AgentMode` is
- * `'build' | 'plan'` and 25+ sites key off that pair (`=== 'plan'`,
- * `Record<AgentMode, ...>`, the plan gate, the subagent `getMode`). Widening it needs a
- * silent-failure audit of every one of them (a miss means "writable when it should be
- * read-only"). Two orthogonal dimensions leave every existing path untouched.
- */
-/** Full Shift+Tab cycle: BUILD -> PLAN -> GOVERN -> PLAN+GOVERN -> BUILD. */
-export const POSTURES_FULL = ['build', 'plan', 'govern', 'plan_govern'];
-/** The classic two-state cycle, used whenever governance is unavailable or switched off. */
-export const POSTURES_CLASSIC = ['build', 'plan'];
-export const POSTURE_LABEL = {
-    build: 'BUILD',
-    plan: 'PLAN',
-    govern: 'GOVERN',
-    plan_govern: 'PLAN+GOVERN',
-};
-/** Lower-case spelling for the `shift+tab <next>` hint clause. */
-export function postureHintWord(posture) {
-    return POSTURE_LABEL[posture].toLowerCase();
-}
-/** (gate mode, governance on) -> posture. Exhaustive; the one place the mapping lives. */
-export function composePosture(mode, governanceOn) {
-    if (mode === 'plan')
-        return governanceOn ? 'plan_govern' : 'plan';
-    return governanceOn ? 'govern' : 'build';
-}
-/** posture -> (gate mode, governance on). Inverse of `composePosture`. */
-export function splitPosture(posture) {
-    switch (posture) {
-        case 'build':
-            return { mode: 'build', governance: false };
-        case 'plan':
-            return { mode: 'plan', governance: false };
-        case 'govern':
-            return { mode: 'build', governance: true };
-        case 'plan_govern':
-            return { mode: 'plan', governance: true };
-    }
-}
-/** True when the posture has governance switched on. */
-export function isGovernancePosture(posture) {
-    return posture === 'govern' || posture === 'plan_govern';
-}
-/**
- * The next posture in `cycle`. A `current` outside the cycle (e.g. `govern` while the
- * cycle is classic) advances to `'build'` - never throws, never loops on itself.
- */
-export function nextPosture(current, cycle) {
-    const index = cycle.indexOf(current);
-    if (index < 0)
-        return 'build';
-    return cycle[(index + 1) % cycle.length];
-}

package/dist/governance/rules/events-table.d.ts

@@ -1,46 +0,0 @@
-/**
- * The event catalogue - Appendix A of the design, 44 rows (governance-mode AC-15).
- *
- * ASCII ONLY (`governance/` is glyph-scanned).
- *
- * THIS TABLE IS THE GOLDEN SOURCE. `governance-ledger.test.ts` pins every row against
- * the reference spec (`token-economy-rules.md` v2.0); a change here is a scoring-rule
- * change, so it must be mirrored in the design document and the golden test in the same
- * commit. Nothing else in the tree may hard-code a delta: settlement, RCA expansion and
- * the inspector tool all look values up here, which is what keeps the engine's
- * automatic events and the inspector's judgement events on ONE accounting path (I-G7).
- *
- * Settlement semantics (design 5.3 / RV-9):
- *   provisional (P) - positive; held in escrow until integration passes; clawback-able.
- *   confirmed   (C) - positive; straight into `confirmed`; not clawback-able.
- *   immediate   (I) - positive scores go straight into `confirmed` (same as C, but the
- *                     reference spec calls the column "Immediate"); negative scores are
- *                     deducted from `confirmed` at once.
- */
-export type EventRole = 'DEV' | 'REV' | 'TEST' | 'ALL';
-export type Settlement = 'provisional' | 'confirmed' | 'immediate';
-/**
- * Who may book an event: E engine, A engine on a mechanical signature (appealable),
- * K a claim ruled on by the inspector, S inspector judgement (evidence required),
- * R inspector root-cause analysis expanded by the engine.
- */
-export type Bookkeeper = 'E' | 'A' | 'K' | 'S' | 'R';
-export declare const EVENT_CODES: readonly ["D1", "D2", "D3", "D4", "D5", "D6", "D7", "D8", "D9", "D10", "D11", "D12", "D13", "D14", "D15", "D16", "D17", "D18", "R1", "R2", "R3", "R4", "R5", "R6", "R7", "R8", "R9", "R10", "R11", "R12", "T1", "T2", "T3", "T4", "T5", "T6", "T7", "T8", "T9", "T10", "C1", "C2", "C3", "C4"];
-export type EventCode = (typeof EVENT_CODES)[number];
-export interface EventDef {
-    code: EventCode;
-    role: EventRole;
-    /** The catalogue delta. C2 is -5 for everyone; the -2 relief is applied by RCA. */
-    delta: number;
-    settlement: Settlement;
-    bookers: readonly Bookkeeper[];
-    /** Short English title, ASCII. Used in ledger rows and the board. */
-    title: string;
-}
-export declare const EVENTS_TABLE: Readonly<Record<EventCode, EventDef>>;
-export declare function isEventCode(value: unknown): value is EventCode;
-export declare function eventDef(code: EventCode): EventDef;
-/** True when the inspector may book this code through `ledger_apply` (judgement events). */
-export declare function isInspectorBookable(code: EventCode): boolean;
-/** The codes `ledger_apply` accepts, in catalogue order. Used in refusal texts. */
-export declare function inspectorBookableCodes(): EventCode[];