nawabari 0.8.0 → 0.9.2

package/dist/product-state-manifest.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Transport-neutral Nawabari Product State Manifest projection.
+ *
+ * The manifest is an output of the existing public state and machine-contract
+ * projections. It is not a lifecycle authority: it does not create a machine,
+ * accept an event, observe a repository, or execute a command. In particular,
+ * internal XState event names, state-node ids, context, and snapshots are not
+ * part of this module's public shape.
+ */
+import { MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, NAWABARI_CONTRACT_API_SCHEMA_VERSION } from "./public-contract.js";
+import type { NawabariCommand, NawabariLifecycleState, NawabariTransitionDecision, NawabariTransitionDecisionProjection } from "./public-state.js";
+export declare const NAWABARI_PRODUCT_STATE_MANIFEST_SCHEMA_VERSION: 1;
+export declare const NAWABARI_PRODUCT_STATE_MANIFEST_ID: "nawabari.product-state-manifest.v1";
+export declare const NAWABARI_PRODUCT_ID: "nawabari";
+export declare const NAWABARI_SESSION_ACTOR_ID: "nawabari.session";
+export declare const NAWABARI_SESSION_LIFECYCLE_SCHEMA_ID: "nawabari.session-lifecycle.v1";
+export declare const NAWABARI_SESSION_COMMAND_SCHEMA_ID: "nawabari.session-command.v1";
+export type NawabariManifestVersionedIdentity = {
+    readonly id: string;
+    readonly version: number;
+};
+type NawabariManifestReason = NawabariTransitionDecision["reason"];
+export type NawabariManifestAuthoritySource = {
+    readonly id: string;
+    readonly kind: "executable" | "public-projection" | "contract-projection";
+    readonly module: string;
+};
+export type NawabariManifestParticipant = {
+    readonly product_id: string;
+    readonly actor_id: string;
+    readonly role: "producer" | "consumer";
+    /** Null means the independent caller has not supplied a contract identity. */
+    readonly contract: NawabariManifestVersionedIdentity | null;
+};
+export type NawabariManifestCorrelation = {
+    readonly mode: "session-scoped" | "not-applicable";
+    readonly field: "session_id" | null;
+    readonly required: boolean;
+    readonly authority: string;
+};
+export type NawabariManifestIdempotency = {
+    readonly mode: "not-declared" | "not-applicable";
+    readonly key: string | null;
+    readonly required: boolean;
+    readonly authority: string;
+};
+export type NawabariManifestUnconditionalTransition = {
+    readonly source_state: NawabariLifecycleState;
+    readonly command: NawabariCommand;
+    readonly guarded: false;
+    readonly allowed: boolean;
+    readonly target: NawabariLifecycleState | null;
+    readonly requires_explicit_intent: boolean;
+    readonly authority: NawabariTransitionDecisionProjection["authority"];
+    readonly reason: NawabariManifestReason;
+};
+export type NawabariManifestGuardedTransition = {
+    readonly source_state: NawabariLifecycleState;
+    readonly command: NawabariCommand;
+    readonly guarded: true;
+    readonly requires_explicit_intent: boolean;
+    readonly authority: NawabariTransitionDecisionProjection["authority"];
+    readonly when_guard_accepts: {
+        readonly allowed: true;
+        readonly target: NawabariLifecycleState;
+        readonly reason: NawabariManifestReason;
+    };
+    readonly when_guard_rejects: {
+        readonly allowed: false;
+        readonly target: null;
+        readonly reason: NawabariManifestReason;
+    };
+};
+export type NawabariManifestTransition = NawabariManifestUnconditionalTransition | NawabariManifestGuardedTransition;
+export type NawabariManifestAcceptedCommand = {
+    readonly id: NawabariCommand;
+    /** Public-state vocabulary; deliberately not a raw XState event name. */
+    readonly public_name: NawabariCommand;
+    readonly kind: "command";
+    readonly schema: NawabariManifestVersionedIdentity;
+    readonly producers: readonly NawabariManifestParticipant[];
+    readonly consumers: readonly NawabariManifestParticipant[];
+    readonly correlation: NawabariManifestCorrelation;
+    readonly idempotency: NawabariManifestIdempotency;
+};
+export type NawabariManifestEmittedEvent = {
+    readonly id: string;
+    readonly schema: NawabariManifestVersionedIdentity;
+    readonly producers: readonly NawabariManifestParticipant[];
+    readonly consumers: readonly NawabariManifestParticipant[];
+    readonly correlation: NawabariManifestCorrelation;
+    readonly idempotency: NawabariManifestIdempotency;
+};
+export type NawabariManifestEmittedEvents = {
+    /** No emitted cross-product event is currently exposed by Nawabari. */
+    readonly status: "not-exposed";
+    readonly schema: NawabariManifestVersionedIdentity | null;
+    readonly events: readonly NawabariManifestEmittedEvent[];
+    readonly producers: readonly NawabariManifestParticipant[];
+    readonly consumers: readonly NawabariManifestParticipant[];
+};
+export type NawabariManifestActor = {
+    readonly id: typeof NAWABARI_SESSION_ACTOR_ID;
+    readonly product_id: typeof NAWABARI_PRODUCT_ID;
+    readonly kind: "session";
+    readonly state: {
+        readonly schema: NawabariManifestVersionedIdentity;
+        readonly states: readonly NawabariLifecycleState[];
+        readonly transitions: readonly NawabariManifestTransition[];
+        readonly authority: "public-state-projection";
+    };
+    readonly accepted_commands: readonly NawabariManifestAcceptedCommand[];
+    readonly emitted_events: NawabariManifestEmittedEvents;
+};
+export interface NawabariProductStateManifest {
+    readonly manifest_id: typeof NAWABARI_PRODUCT_STATE_MANIFEST_ID;
+    readonly schema_version: typeof NAWABARI_PRODUCT_STATE_MANIFEST_SCHEMA_VERSION;
+    readonly product: {
+        readonly id: typeof NAWABARI_PRODUCT_ID;
+        readonly name: "Nawabari";
+        readonly package_name: "nawabari";
+        readonly package_version: string;
+    };
+    readonly public_contract: {
+        readonly contract_id: typeof MACHINE_CONTRACT_ID;
+        readonly schema_version: typeof MACHINE_CONTRACT_SCHEMA_VERSION;
+        readonly api_schema_version: typeof NAWABARI_CONTRACT_API_SCHEMA_VERSION;
+    };
+    readonly authority: {
+        readonly model: "projection";
+        readonly source_of_truth: readonly NawabariManifestAuthoritySource[];
+        readonly output_role: "generated-artifact";
+    };
+    readonly composition: {
+        readonly participant_schema: NawabariManifestVersionedIdentity;
+        readonly connection_model: "independent-product-actors";
+        readonly transport: "adapter-owned";
+    };
+    readonly actors: readonly NawabariManifestActor[];
+}
+/** Generate the deterministic public manifest for the installed package version. */
+export declare function generateNawabariProductStateManifest(packageVersion?: string): NawabariProductStateManifest;
+/** Naming parallel to `nawabariMachineContract`; both return the same projection. */
+export declare const nawabariProductStateManifest: typeof generateNawabariProductStateManifest;
+/** Stable byte representation for checked-in/generated artifacts. */
+export declare function serializeNawabariProductStateManifest(manifest?: NawabariProductStateManifest): string;
+/**
+ * Render a deterministic Mermaid state diagram from manifest data. The
+ * manifest is the input boundary; this renderer contains no lifecycle graph.
+ */
+export declare function renderNawabariSessionLifecycleDiagram(manifest?: NawabariProductStateManifest): string;
+export {};

package/dist/product-state-manifest.js

@@ -0,0 +1,240 @@
+/**
+ * Transport-neutral Nawabari Product State Manifest projection.
+ *
+ * The manifest is an output of the existing public state and machine-contract
+ * projections. It is not a lifecycle authority: it does not create a machine,
+ * accept an event, observe a repository, or execute a command. In particular,
+ * internal XState event names, state-node ids, context, and snapshots are not
+ * part of this module's public shape.
+ */
+import { createRequire } from "node:module";
+import { MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, NAWABARI_CONTRACT_API_SCHEMA_VERSION, nawabariMachineContract, } from "./public-contract.js";
+import { NAWABARI_LIFECYCLE_STATES, NAWABARI_STATE_API_SCHEMA_VERSION, NAWABARI_TRANSITION_TABLE, } from "./public-state.js";
+import { SESSION_LIFECYCLE_CLASSIFICATION_SCHEMA_VERSION } from "./session-lifecycle-classification.js";
+const installedPackageMetadata = createRequire(import.meta.url)("../package.json");
+export const NAWABARI_PRODUCT_STATE_MANIFEST_SCHEMA_VERSION = 1;
+export const NAWABARI_PRODUCT_STATE_MANIFEST_ID = "nawabari.product-state-manifest.v1";
+export const NAWABARI_PRODUCT_ID = "nawabari";
+export const NAWABARI_SESSION_ACTOR_ID = "nawabari.session";
+export const NAWABARI_SESSION_LIFECYCLE_SCHEMA_ID = "nawabari.session-lifecycle.v1";
+export const NAWABARI_SESSION_COMMAND_SCHEMA_ID = "nawabari.session-command.v1";
+const SOURCE_OF_TRUTH = Object.freeze([
+    Object.freeze({
+        id: "session-lifecycle-machine",
+        kind: "executable",
+        module: "src/state/session/machine.ts",
+    }),
+    Object.freeze({
+        id: "public-state-lifecycle-projection",
+        kind: "public-projection",
+        module: "src/public-state.ts",
+    }),
+    Object.freeze({
+        id: "machine-contract-projection",
+        kind: "contract-projection",
+        module: "src/contract.ts",
+    }),
+    Object.freeze({
+        id: "public-contract-package-boundary",
+        kind: "public-projection",
+        module: "src/public-contract.ts",
+    }),
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function lifecycleCapability(contract) {
+    if (!Array.isArray(contract.capabilities)) {
+        throw new Error("Nawabari machine contract has no capability inventory");
+    }
+    const capability = contract.capabilities.find((candidate) => isRecord(candidate) && candidate.id === "session-diagnostics");
+    if (!isRecord(capability) || !isRecord(capability.lifecycle)) {
+        throw new Error("Nawabari machine contract has no session lifecycle projection");
+    }
+    return capability.lifecycle;
+}
+function assertContractProjectionParity(contract) {
+    const lifecycle = lifecycleCapability(contract);
+    const publicStates = [...NAWABARI_LIFECYCLE_STATES];
+    const publicTransitions = NAWABARI_TRANSITION_TABLE;
+    if (JSON.stringify(lifecycle.states) !== JSON.stringify(publicStates)) {
+        throw new Error("Nawabari Product State Manifest source projections disagree on lifecycle states");
+    }
+    if (JSON.stringify(lifecycle.transition_table) !== JSON.stringify(publicTransitions)) {
+        throw new Error("Nawabari Product State Manifest source projections disagree on lifecycle transitions");
+    }
+}
+function projectTransition(sourceState, transition) {
+    if (transition.guarded) {
+        return Object.freeze({
+            source_state: sourceState,
+            command: transition.operation,
+            guarded: true,
+            requires_explicit_intent: transition.requiresExplicitIntent,
+            authority: transition.authority,
+            when_guard_accepts: Object.freeze({
+                allowed: true,
+                target: transition.whenGuardAccepts.target,
+                reason: transition.whenGuardAccepts.reason,
+            }),
+            when_guard_rejects: Object.freeze({
+                allowed: false,
+                target: null,
+                reason: transition.whenGuardRejects.reason,
+            }),
+        });
+    }
+    return Object.freeze({
+        source_state: sourceState,
+        command: transition.operation,
+        guarded: false,
+        allowed: transition.allowed,
+        target: transition.target,
+        requires_explicit_intent: transition.requiresExplicitIntent,
+        authority: transition.authority,
+        reason: transition.reason,
+    });
+}
+function projectTransitions() {
+    return Object.freeze(NAWABARI_LIFECYCLE_STATES.flatMap((state) => NAWABARI_TRANSITION_TABLE[state].map((transition) => projectTransition(state, transition))));
+}
+function uniqueCommands(transitions) {
+    const commands = [];
+    for (const transition of transitions) {
+        if (!commands.includes(transition.command))
+            commands.push(transition.command);
+    }
+    return Object.freeze(commands);
+}
+function participant(productId, actorId, role, contract) {
+    return Object.freeze({
+        product_id: productId,
+        actor_id: actorId,
+        role,
+        contract: contract === null ? null : Object.freeze({ ...contract }),
+    });
+}
+function acceptedCommand(command) {
+    return Object.freeze({
+        id: command,
+        public_name: command,
+        kind: "command",
+        schema: Object.freeze({ id: NAWABARI_SESSION_COMMAND_SCHEMA_ID, version: NAWABARI_STATE_API_SCHEMA_VERSION }),
+        producers: Object.freeze([participant("external", "caller", "producer", null)]),
+        consumers: Object.freeze([
+            participant("nawabari", NAWABARI_SESSION_ACTOR_ID, "consumer", {
+                id: MACHINE_CONTRACT_ID,
+                version: MACHINE_CONTRACT_SCHEMA_VERSION,
+            }),
+        ]),
+        correlation: Object.freeze({
+            mode: "session-scoped",
+            field: "session_id",
+            required: false,
+            authority: "public-state observation boundary",
+        }),
+        idempotency: Object.freeze({
+            mode: "not-declared",
+            key: null,
+            required: false,
+            authority: "existing command/runtime contract",
+        }),
+    });
+}
+function emittedEvents() {
+    return Object.freeze({
+        status: "not-exposed",
+        schema: null,
+        events: Object.freeze([]),
+        producers: Object.freeze([]),
+        consumers: Object.freeze([]),
+    });
+}
+/** Generate the deterministic public manifest for the installed package version. */
+export function generateNawabariProductStateManifest(packageVersion = installedPackageMetadata.version) {
+    const contract = nawabariMachineContract(packageVersion);
+    assertContractProjectionParity(contract);
+    const transitions = projectTransitions();
+    const commands = uniqueCommands(transitions);
+    const actor = Object.freeze({
+        id: NAWABARI_SESSION_ACTOR_ID,
+        product_id: NAWABARI_PRODUCT_ID,
+        kind: "session",
+        state: Object.freeze({
+            schema: Object.freeze({
+                id: NAWABARI_SESSION_LIFECYCLE_SCHEMA_ID,
+                version: SESSION_LIFECYCLE_CLASSIFICATION_SCHEMA_VERSION,
+            }),
+            states: Object.freeze([...NAWABARI_LIFECYCLE_STATES]),
+            transitions,
+            authority: "public-state-projection",
+        }),
+        accepted_commands: Object.freeze(commands.map(acceptedCommand)),
+        emitted_events: emittedEvents(),
+    });
+    return Object.freeze({
+        manifest_id: NAWABARI_PRODUCT_STATE_MANIFEST_ID,
+        schema_version: NAWABARI_PRODUCT_STATE_MANIFEST_SCHEMA_VERSION,
+        product: Object.freeze({
+            id: NAWABARI_PRODUCT_ID,
+            name: "Nawabari",
+            package_name: "nawabari",
+            package_version: packageVersion,
+        }),
+        public_contract: Object.freeze({
+            contract_id: MACHINE_CONTRACT_ID,
+            schema_version: MACHINE_CONTRACT_SCHEMA_VERSION,
+            api_schema_version: NAWABARI_CONTRACT_API_SCHEMA_VERSION,
+        }),
+        authority: Object.freeze({
+            model: "projection",
+            source_of_truth: SOURCE_OF_TRUTH,
+            output_role: "generated-artifact",
+        }),
+        composition: Object.freeze({
+            participant_schema: Object.freeze({ id: "nawabari.product-participant.v1", version: 1 }),
+            connection_model: "independent-product-actors",
+            transport: "adapter-owned",
+        }),
+        actors: Object.freeze([actor]),
+    });
+}
+/** Naming parallel to `nawabariMachineContract`; both return the same projection. */
+export const nawabariProductStateManifest = generateNawabariProductStateManifest;
+/** Stable byte representation for checked-in/generated artifacts. */
+export function serializeNawabariProductStateManifest(manifest = generateNawabariProductStateManifest()) {
+    return `${JSON.stringify(manifest, null, 2)}\n`;
+}
+function diagramStateId(state) {
+    return state.replace(/[^A-Za-z0-9_]/gu, "_");
+}
+function diagramTransitionLines(transition) {
+    const source = diagramStateId(transition.source_state);
+    if (transition.guarded) {
+        return [
+            `  ${source} --> ${diagramStateId(transition.when_guard_accepts.target)} : ${transition.command} [guard accepts]`,
+            `  %% ${transition.source_state} -- ${transition.command} [guard rejects] --> no public transition (${transition.when_guard_rejects.reason})`,
+        ];
+    }
+    if (!transition.allowed || transition.target === null) {
+        return [`  %% ${transition.source_state} -- ${transition.command} --> no public transition (${transition.reason})`];
+    }
+    return [`  ${source} --> ${diagramStateId(transition.target)} : ${transition.command}`];
+}
+/**
+ * Render a deterministic Mermaid state diagram from manifest data. The
+ * manifest is the input boundary; this renderer contains no lifecycle graph.
+ */
+export function renderNawabariSessionLifecycleDiagram(manifest = generateNawabariProductStateManifest()) {
+    const actor = manifest.actors.find((candidate) => candidate.id === NAWABARI_SESSION_ACTOR_ID);
+    if (actor === undefined)
+        throw new Error(`Manifest is missing actor ${NAWABARI_SESSION_ACTOR_ID}`);
+    const lines = ["%% Generated from Nawabari Product State Manifest; do not edit.", "stateDiagram-v2"];
+    for (const state of actor.state.states) {
+        lines.push(`  state "${state}" as ${diagramStateId(state)}`);
+    }
+    for (const transition of actor.state.transitions)
+        lines.push(...diagramTransitionLines(transition));
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=product-state-manifest.js.map

package/dist/product-state-manifest.js.map

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

package/dist/public-contract.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stable, transport-neutral package boundary for Nawabari machine-contract
+ * discovery (#257; see docs/architecture/xstate-state-architecture.md,
+ * "Public library boundary").
+ *
+ * This module lets a cross-product caller discover the installed package's
+ * versioned capability inventory, result-schema mappings, failure-code
+ * vocabulary, and public session-lifecycle projection (#256) without
+ * spawning the CLI's `capabilities --json` command and parsing its output.
+ * It is a thin, version-defaulted wrapper over the existing `contract.ts`
+ * projection; it introduces no independent contract authority.
+ */
+import type { JsonObject } from "./domain/errors.js";
+import { machineContract, MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, REGISTRY_LOCK_RECOVERY_CONTRACT_ID, REGISTRY_LOCK_RECOVERY_CONTRACT_VERSION, RESOURCE_CLAIM_MACHINE_CONTRACT_ID, RESOURCE_CLAIM_MACHINE_CONTRACT_VERSION, RESOURCE_CLAIM_RECOVERY_SCHEMA, RESOURCE_CLAIM_RESULT_SCHEMA, RESOURCE_CLAIM_TRANSITION_MATRIX_ID } from "./contract.js";
+export { machineContract, MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, REGISTRY_LOCK_RECOVERY_CONTRACT_ID, REGISTRY_LOCK_RECOVERY_CONTRACT_VERSION, RESOURCE_CLAIM_MACHINE_CONTRACT_ID, RESOURCE_CLAIM_MACHINE_CONTRACT_VERSION, RESOURCE_CLAIM_RECOVERY_SCHEMA, RESOURCE_CLAIM_RESULT_SCHEMA, RESOURCE_CLAIM_TRANSITION_MATRIX_ID, };
+/** Schema generation for this public contract-discovery API module itself. */
+export declare const NAWABARI_CONTRACT_API_SCHEMA_VERSION: 1;
+/**
+ * Discover the installed Nawabari package's machine contract: capability
+ * inventory, result-schema mappings, failure-code vocabulary, and the
+ * XState-derived public session-lifecycle projection. Defaults to the
+ * installed package's own version; pass an explicit version only to
+ * describe a different generation of this same contract shape.
+ */
+export declare function nawabariMachineContract(packageVersion?: string): JsonObject;

package/dist/public-contract.js

@@ -0,0 +1,29 @@
+/**
+ * Stable, transport-neutral package boundary for Nawabari machine-contract
+ * discovery (#257; see docs/architecture/xstate-state-architecture.md,
+ * "Public library boundary").
+ *
+ * This module lets a cross-product caller discover the installed package's
+ * versioned capability inventory, result-schema mappings, failure-code
+ * vocabulary, and public session-lifecycle projection (#256) without
+ * spawning the CLI's `capabilities --json` command and parsing its output.
+ * It is a thin, version-defaulted wrapper over the existing `contract.ts`
+ * projection; it introduces no independent contract authority.
+ */
+import { createRequire } from "node:module";
+import { machineContract, MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, REGISTRY_LOCK_RECOVERY_CONTRACT_ID, REGISTRY_LOCK_RECOVERY_CONTRACT_VERSION, RESOURCE_CLAIM_MACHINE_CONTRACT_ID, RESOURCE_CLAIM_MACHINE_CONTRACT_VERSION, RESOURCE_CLAIM_RECOVERY_SCHEMA, RESOURCE_CLAIM_RESULT_SCHEMA, RESOURCE_CLAIM_TRANSITION_MATRIX_ID, } from "./contract.js";
+export { machineContract, MACHINE_CONTRACT_ID, MACHINE_CONTRACT_SCHEMA_VERSION, REGISTRY_LOCK_RECOVERY_CONTRACT_ID, REGISTRY_LOCK_RECOVERY_CONTRACT_VERSION, RESOURCE_CLAIM_MACHINE_CONTRACT_ID, RESOURCE_CLAIM_MACHINE_CONTRACT_VERSION, RESOURCE_CLAIM_RECOVERY_SCHEMA, RESOURCE_CLAIM_RESULT_SCHEMA, RESOURCE_CLAIM_TRANSITION_MATRIX_ID, };
+/** Schema generation for this public contract-discovery API module itself. */
+export const NAWABARI_CONTRACT_API_SCHEMA_VERSION = 1;
+const installedPackageMetadata = createRequire(import.meta.url)("../package.json");
+/**
+ * Discover the installed Nawabari package's machine contract: capability
+ * inventory, result-schema mappings, failure-code vocabulary, and the
+ * XState-derived public session-lifecycle projection. Defaults to the
+ * installed package's own version; pass an explicit version only to
+ * describe a different generation of this same contract shape.
+ */
+export function nawabariMachineContract(packageVersion = installedPackageMetadata.version) {
+    return machineContract(packageVersion);
+}
+//# sourceMappingURL=public-contract.js.map

package/dist/public-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-contract.js","sourceRoot":"","sources":["../src/public-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,kCAAkC,EAClC,uCAAuC,EACvC,8BAA8B,EAC9B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,kCAAkC,EAClC,uCAAuC,EACvC,8BAA8B,EAC9B,4BAA4B,EAC5B,mCAAmC,GACpC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAU,CAAC;AAE/D,MAAM,wBAAwB,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE1G;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,iBAAyB,wBAAwB,CAAC,OAAO;IAC/F,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;AACzC,CAAC"}

package/dist/public-state.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Stable, transport-neutral package boundary for Nawabari state/contract
+ * integration (#257; see docs/architecture/xstate-state-architecture.md,
+ * "Public library boundary").
+ *
+ * This module is the supported way for a cross-product caller (a future
+ * Mottainai/Inari adapter, or any other Node consumer) to obtain a public
+ * lifecycle observation/snapshot and transition-decision data without
+ * spawning the CLI and parsing its output, and without reaching into XState
+ * machine/actor internals. Every exported type and function here is a
+ * projection of the existing Core/#256 lifecycle authority
+ * (`session-lifecycle-classification.ts` and `SessionRegistry`); this module
+ * introduces no independent state or transition authority.
+ *
+ * Raw XState machine definitions, actor refs, internal state-node ids, and
+ * private machine context are never exported here. Mutating a session
+ * (close/discard/claim/commit/push/...) still requires the existing
+ * `SessionRegistry` Git/filesystem/registry authority; nothing in this
+ * module lets a caller manufacture or bypass that authorization by
+ * constructing an observation or transition decision by hand.
+ */
+import type { SessionLifecycleBlocker, SessionLifecycleClassification, SessionLifecycleCloseReadiness, SessionLifecycleGuardedTransition, SessionLifecycleObservation, SessionLifecycleOperation, SessionLifecyclePhase, SessionLifecycleState, SessionLifecycleTransition, SessionLifecycleTransitionProjection, SessionLifecycleUnconditionalTransition } from "./session-lifecycle-classification.js";
+/** Schema generation for this public state-API module itself. */
+export declare const NAWABARI_STATE_API_SCHEMA_VERSION: 1;
+/** Public lifecycle command/event vocabulary. Never a raw XState event type. */
+export type NawabariCommand = SessionLifecycleOperation;
+/** Caller-supplied observation input. Structural, not tied to a live session. */
+export type NawabariObservation = SessionLifecycleObservation;
+export type NawabariObservationBlocker = SessionLifecycleBlocker;
+export type NawabariObservationPhase = SessionLifecyclePhase;
+export type NawabariCloseReadiness = SessionLifecycleCloseReadiness;
+/** Public lifecycle state name. Never an internal XState state-node id. */
+export type NawabariLifecycleState = SessionLifecycleState;
+export declare const NAWABARI_LIFECYCLE_STATES: readonly NawabariLifecycleState[];
+/**
+ * Public projection of one classified session: its lifecycle state plus
+ * every per-command transition decision. This is a public projection, not a
+ * raw XState snapshot.
+ */
+export type NawabariStateSnapshot = SessionLifecycleClassification;
+/** One command's transition decision: whether/where it would move the state, and why. */
+export type NawabariTransitionDecision = SessionLifecycleTransition;
+export type NawabariUnconditionalTransitionDecision = SessionLifecycleUnconditionalTransition;
+export type NawabariGuardedTransitionDecision = SessionLifecycleGuardedTransition;
+export type NawabariTransitionDecisionProjection = SessionLifecycleTransitionProjection;
+/** The complete static state/command transition-decision table, for discovery. */
+export declare const NAWABARI_TRANSITION_TABLE: Readonly<Record<NawabariLifecycleState, readonly NawabariTransitionDecisionProjection[]>>;
+/**
+ * Classify an already-observed session into its public state snapshot and
+ * per-command transition decisions. Pure and transport-neutral: it performs
+ * no Git/filesystem/registry observation of its own.
+ */
+export declare function classifyNawabariState(observation: NawabariObservation): NawabariStateSnapshot;
+/** Return one command's transition decision from an already-classified snapshot. */
+export declare function nawabariTransitionDecision(snapshot: NawabariStateSnapshot, command: NawabariCommand): NawabariTransitionDecision;
+/** Commands the canonical machine currently admits for an already-classified snapshot. */
+export declare function availableNawabariCommands(snapshot: NawabariStateSnapshot): readonly NawabariCommand[];
+export interface NawabariSessionSnapshotOptions {
+    /** Repository/worktree to resolve the session registry from. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+    /** Defaults to the session owning `cwd` when omitted. */
+    readonly sessionId?: string;
+    /** Caller-supplied integration revision, independently re-verified before it affects close readiness. */
+    readonly integratedRevision?: string;
+    /** `current` reports ownership as it exists; `termination` projects close readiness. Defaults to `current`. */
+    readonly phase?: NawabariObservationPhase;
+}
+/**
+ * Observe one real, already-provisioned Nawabari session and return its
+ * public state snapshot. This reuses the existing `SessionRegistry`
+ * Git/filesystem/session-registry authority — the same authority `session
+ * inspect` uses — without spawning or parsing CLI output. It never mutates a
+ * session, claim, branch, or worktree.
+ */
+export declare function getNawabariSessionStateSnapshot(options?: NawabariSessionSnapshotOptions): NawabariStateSnapshot;

package/dist/public-state.js

@@ -0,0 +1,60 @@
+/**
+ * Stable, transport-neutral package boundary for Nawabari state/contract
+ * integration (#257; see docs/architecture/xstate-state-architecture.md,
+ * "Public library boundary").
+ *
+ * This module is the supported way for a cross-product caller (a future
+ * Mottainai/Inari adapter, or any other Node consumer) to obtain a public
+ * lifecycle observation/snapshot and transition-decision data without
+ * spawning the CLI and parsing its output, and without reaching into XState
+ * machine/actor internals. Every exported type and function here is a
+ * projection of the existing Core/#256 lifecycle authority
+ * (`session-lifecycle-classification.ts` and `SessionRegistry`); this module
+ * introduces no independent state or transition authority.
+ *
+ * Raw XState machine definitions, actor refs, internal state-node ids, and
+ * private machine context are never exported here. Mutating a session
+ * (close/discard/claim/commit/push/...) still requires the existing
+ * `SessionRegistry` Git/filesystem/registry authority; nothing in this
+ * module lets a caller manufacture or bypass that authorization by
+ * constructing an observation or transition decision by hand.
+ */
+import { SessionRegistry } from "./session-registry.js";
+import { availableLifecycleOperations, classifySessionLifecycle, lifecycleTransition, SESSION_LIFECYCLE_STATES, SESSION_LIFECYCLE_TRANSITION_TABLE, } from "./session-lifecycle-classification.js";
+/** Schema generation for this public state-API module itself. */
+export const NAWABARI_STATE_API_SCHEMA_VERSION = 1;
+export const NAWABARI_LIFECYCLE_STATES = SESSION_LIFECYCLE_STATES;
+/** The complete static state/command transition-decision table, for discovery. */
+export const NAWABARI_TRANSITION_TABLE = SESSION_LIFECYCLE_TRANSITION_TABLE;
+/**
+ * Classify an already-observed session into its public state snapshot and
+ * per-command transition decisions. Pure and transport-neutral: it performs
+ * no Git/filesystem/registry observation of its own.
+ */
+export function classifyNawabariState(observation) {
+    return classifySessionLifecycle(observation);
+}
+/** Return one command's transition decision from an already-classified snapshot. */
+export function nawabariTransitionDecision(snapshot, command) {
+    return lifecycleTransition(snapshot, command);
+}
+/** Commands the canonical machine currently admits for an already-classified snapshot. */
+export function availableNawabariCommands(snapshot) {
+    return availableLifecycleOperations(snapshot);
+}
+/**
+ * Observe one real, already-provisioned Nawabari session and return its
+ * public state snapshot. This reuses the existing `SessionRegistry`
+ * Git/filesystem/session-registry authority — the same authority `session
+ * inspect` uses — without spawning or parsing CLI output. It never mutates a
+ * session, claim, branch, or worktree.
+ */
+export function getNawabariSessionStateSnapshot(options = {}) {
+    const registry = new SessionRegistry(options.cwd === undefined ? undefined : { cwd: options.cwd });
+    return registry.classifyLifecycle({
+        sessionId: options.sessionId ?? null,
+        integratedRevision: options.integratedRevision ?? null,
+        phase: options.phase,
+    });
+}
+//# sourceMappingURL=public-state.js.map

package/dist/public-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-state.js","sourceRoot":"","sources":["../src/public-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,kCAAkC,GACnC,MAAM,uCAAuC,CAAC;AAe/C,iEAAiE;AACjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AAa5D,MAAM,CAAC,MAAM,yBAAyB,GAAsC,wBAAwB,CAAC;AAerG,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAElC,kCAAkC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAgC;IACpE,OAAO,wBAAwB,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,0BAA0B,CACxC,QAA+B,EAC/B,OAAwB;IAExB,OAAO,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CAAC,QAA+B;IACvE,OAAO,4BAA4B,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAaD;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAAC,UAA0C,EAAE;IAC1F,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnG,OAAO,QAAQ,CAAC,iBAAiB,CAAC;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/session-lifecycle-actions.d.ts

@@ -1,4 +1,4 @@
-import type { SessionLifecycleClassification } from "./session-lifecycle-classification.js";
+import { type SessionLifecycleClassification } from "./session-lifecycle-classification.js";
 /**
  * The small, public vocabulary for lifecycle recovery.  These values are
  * descriptions of an available caller action; none of them grants mutation
@@ -54,8 +54,9 @@ export type SessionLifecycleActionProjectionInput = {
 };
 /**
  * Project one canonical lifecycle observation into bounded typed caller
- * actions.  The classifier remains the sole owner of lifecycle state; this
- * function only consumes its result and already-authoritative blocker facts.
+ * actions.  Lifecycle state and admissibility arrive through the canonical
+ * classification projection; this function only consumes that result and
+ * already-authoritative blocker facts.
  */
 export declare function projectSessionLifecycleActions(input: SessionLifecycleActionProjectionInput): readonly SessionLifecycleAction[];
 export declare function primarySessionLifecycleAction(input: SessionLifecycleActionProjectionInput): SessionLifecycleAction | undefined;