@astrosheep/keiyaku 4.6.7 → 4.6.9

package/build/src/git/observe.d.ts

@@ -49,8 +49,12 @@ export type BindTargetSelection = Readonly<{
 export declare function normalizeTargetBranch(repository: GitRepository, input: string): Promise<string | null>;
 /** Read one worktree's attached branch, or null for detached HEAD. */
 export declare function currentBranch(repository: GitRepository, path?: string): Promise<string | null>;
-/** Observe bind's tender start and optional reward target without creating persistent state. */
-export declare function observeBindCoordinates(repository: GitRepository, selection?: BindTargetSelection): Promise<BindCoordinatesObservation | UnbornHeadObservation | null>;
+/**
+ * Observe bind's tender start and optional reward target without creating persistent state.
+ * `current-branch` reads the observed worktree coordinate's own attached branch; the caller names
+ * which coordinate it wants observed.
+ */
+export declare function observeBindCoordinates(repository: GitRepository, selection: BindTargetSelection): Promise<BindCoordinatesObservation | UnbornHeadObservation | null>;
 export declare function observeActiveContractWorld(observation: GitReadObservation): Promise<ActiveContractWorldObservation>;
 export declare function observeContractWorld(observation: GitReadObservation, requested?: readonly ContractId[]): Promise<ContractWorldObservation>;
 export declare function observeContractsForAdmissionAt(repository: GitRepository, channel: GitDecodeChannel, ids: readonly ContractId[], selection?: GitTreeSelection): Promise<GitDecisionObservation>;

package/build/src/git/observe.js

@@ -77,8 +77,12 @@ async function observeHeadCoordinates(repository) {
         throw error;
     }
 }
-/** Observe bind's tender start and optional reward target without creating persistent state. */
-export async function observeBindCoordinates(repository, selection = { kind: "targetless" }) {
+/**
+ * Observe bind's tender start and optional reward target without creating persistent state.
+ * `current-branch` reads the observed worktree coordinate's own attached branch; the caller names
+ * which coordinate it wants observed.
+ */
+export async function observeBindCoordinates(repository, selection) {
     if (selection.kind === "explicit") {
         const requestedTarget = selection.target;
         if (isKeiyakuOwnedRef(requestedTarget)) {

package/build/src/identity/coordinates.d.ts

@@ -1,4 +1,4 @@
-export type IdentityFamily = "aku" | "kei" | "task" | "resp";
+export type IdentityFamily = "aku" | "kei" | "debt" | "resp";
 export declare function identityCoordinate(input: Readonly<{
     family: IdentityFamily;
     segments: readonly string[];

package/build/src/index.d.ts

@@ -1,61 +1,61 @@
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { AuthorityCorruptionError } from "./core/facts/errors.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { Delivery } from "./library/delivery.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { Keiyaku } from "./library/keiyaku.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { KeiyakuError } from "./library/outcome.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { NoGitWorldError, Repo } from "./library/repo.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { actorId } from "./core/facts/types.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { z } from "zod";
-export { ALLOWED_ACTIONS, Akuma, AkumaBusyError, AkumaDecodeError, AkumaNotBornError, AkumaProviderError, Schema, } from "./akuma/index.js";
-export type { ActivityHistory, ActivityRow, AkuId, AkumaAskObservation, AkumaAskOptions, AkumaAskResult, AkumaBirthInput, AkumaHistoryOptions, AkumaIdleOptions, AkumaIdleResult, AkumaSignalOptions, AkumaStatus, AkumaTellOptions, AkumaTellResult, AllowedAction, AllowedActions, InterruptReceipt, JsonSchema, JsonSchemaDocument, KillEvidence, SchemaLike, StandardSchemaV1, } from "./akuma/index.js";
+export { ALLOWED_ACTIONS, Akuma, AkumaArchetypeError, AkumaBusyError, AkumaDecodeError, AkumaNotBornError, AkumaProviderError, Schema, listArchetypeDefinitions, } from "./akuma/index.js";
+export type { AkumaCaller, AkumaOrigin, ActivityHistory, ActivityRow, AkuId, AkumaAskObservation, AkumaAskOptions, AkumaAskResult, AkumaBirthInput, AkumaHistoryOptions, AkumaHostOptions, AkumaIdleOptions, AkumaIdleResult, AkumaSignalOptions, AkumaStatus, AkumaStreamSnapshot, AkumaTellOptions, AkumaTellResult, AllowedAction, AllowedActions, ArchetypeCatalog, ArchetypeCatalogInput, ArchetypeCatalogRow, InterruptReceipt, JsonSchema, JsonSchemaDocument, KillEvidence, SchemaLike, StandardSchemaV1, } from "./akuma/index.js";
 export type { ActorId, ChangeId, ContractHead, ContractId, ContractState, JournalEntry as Fact, FactKind, SnapshotId, } from "./core/facts/types.js";
-export { kanshi, observeKanshi, selectKanshi, selectRegion } from "./kanshi/index.js";
-export type { AkumaKanshiRow, AkumaKanshiWorld, ContractEndpointObservation, ContractHolderObservation, ContractKanshiBoard, ContractKanshiRow, KanshiInput, KanshiRegionSelection, KanshiReport, KanshiSelection, RegionDeclaration, RegionRead, Section, TaskKanshiRow, TaskKanshiWorld, } from "./kanshi/index.js";
+export { kanshi, kanshiCategory, observeKanshi, selectKanshi, selectRegion } from "./kanshi/index.js";
+export type { AkumaKanshiRow, AkumaKanshiWorld, ContractEndpointObservation, ContractHolderObservation, ContractKanshiBoard, ContractKanshiRow, KanshiCategoryInput, KanshiCategoryReport, KanshiInput, KanshiRegionSelection, KanshiReport, KanshiSelection, RegionDeclaration, RegionRead, Section, DebtKanshiRow, DebtKanshiWorld, } from "./kanshi/index.js";
 export { AkumaAddressError, AkumaWorldScopeError, Akumas } from "./library/akumas.js";
-export type { AkumaAddressInput, AkumaAskInput, AkumaHistoryInput, AkumaHistoryResult, AkumaKillInput, AkumaKillResult, AkumaList, AkumaListInput, AkumaObservation, AkumaObservationStage, AkumaTellInput, AkumaWaitInput, AkumaWaitResult, AkumaWorldScopeRefusal, CallInput, CallResult, CallWaitHead, CreatedTaskObservation, DispatchAssociation, DispatchStage, ForkInput, ForkResult, TellResult, TellWake, WaitObservedAkuma, WaitObserver, WaitSelectedAkuma, } from "./library/akumas.js";
+export type { AkumaAddressInput, AkumaAskInput, AkumaHistoryInput, AkumaHistoryResult, AkumaKillInput, AkumaKillResult, AkumaList, AkumaListInput, AkumaObservation, AkumaObservationStage, AkumaTellInput, AkumaWaitInput, AkumaWaitResult, AkumaWorldScopeRefusal, CallInput, CallResult, CallWaitHead, CreatedDebtObservation, DispatchAssociation, DispatchStage, ForkInput, ForkResult, TellResult, TellWake, } from "./library/akumas.js";
 export type { ContinuationReport } from "./library/continuation.js";
 export type { KeiyakuLibrary, ReconcileInput } from "./library/contract-composition.js";
 export type { AbandonOutcome, AmendOutcome, ArcOutcome, AuditOutcome, BindOutcome, BindResult, DeliverOutcome, ReviewOutcome, } from "./library/contract-outcomes.js";
-export type { AbandonInput, AmendInput, ArcInput, BindInput, ContractHistory, ContractHistoryEvent, ContractList, ContractListInput, ContractObservationInput, DeliverInput, KeiyakuSelectInput, LocalContractComposition, ReviewInput, } from "./library/contract-types.js";
+export type { AbandonInput, AmendInput, ArcInput, BindInput, ContractHistory, ContractHistoryEvent, ContractList, ContractListInput, ContractObservationInput, ContractResolveInput, ContractResolution, ContractSelectorRefusal, DeliverInput, KeiyakuSelectInput, LocalContractComposition, ReviewInput, } from "./library/contract-types.js";
 export { nukeKeiyaku as nuke } from "./library/nuke.js";
 export type { NukeInput, NukeResult } from "./library/nuke.js";
 export type { InvocationEffect, KeiyakuErrorCategory, PartialOutcomeEnvelope, PendingSurface, ReconciliationLag, Review, } from "./library/outcome.js";
@@ -63,7 +63,7 @@ export type { ReconcileCompletion, RepoContractReconcileReport, RepoReconcileRep
 export type { KeiyakuRefusal, KeiyakuRetryReason, NukeConfirmationRefusal, NukeConfirmationRequiredRefusal, OperationRetries, } from "./library/refusal.js";
 export type { RegionOverlap } from "./library/region.js";
 export type { RepoAtInput } from "./library/repo.js";
-export type { KeiyakuPlugin, PluginBodyEnd, PluginContext, PluginHooks, PluginInstance, PluginManifest, PluginOutcome, PluginSignal, PluginSignalMap, } from "./plugin/public.js";
+export type { KeiyakuPlugin, PluginAkumaCaller, PluginAkumaOrigin, PluginBodyEnd, PluginContext, PluginHooks, PluginInstance, PluginManifest, PluginOutcome, PluginSignal, PluginSignalMap, } from "./plugin/public.js";
 export type { AuditReport } from "./protocol/audit.js";
 export type { IntegrationConflictMaterialized, VerificationReuse } from "./protocol/deliver.js";
 export type { ExecutionObservation, ExecutionObserver } from "./protocol/execution-observation.js";
@@ -74,8 +74,8 @@ export { SettingsError, settings } from "./settings.js";
 export type { Gate } from "./library/contract-types.js";
 export type { Settings, SettingsEntry, SettingsInput, SettingsNamespaceFailure, SettingsNamespaceView, SettingsScope, SettingsScopeState, } from "./settings.js";
 export type { SettlementAction, SettlementLag, SettlementReport } from "./settlement/settle.js";
-export type * from "./task/index.js";
-export { TASK_RELATION_PREDICATE_FIELDS, TaskAuthorityCorruptionError, Tasks } from "./task/index.js";
+export type * from "./debt/index.js";
+export { DEBT_RELATION_PREDICATE_FIELDS, DebtAuthorityCorruptionError, Debts } from "./debt/index.js";
 export { World, WorldError } from "./world.js";
 export type { WorldResolution, WorldResolutionInput, WorldRoot } from "./world.js";
 export type { ReconcileReport, TopologyEffect } from "./library/reconcile.js";

package/build/src/index.js

@@ -1,54 +1,54 @@
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { AuthorityCorruptionError } from "./core/facts/errors.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { Delivery } from "./library/delivery.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { Keiyaku } from "./library/keiyaku.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { KeiyakuError } from "./library/outcome.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { NoGitWorldError, Repo } from "./library/repo.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { actorId } from "./core/facts/types.js";
 /**
- * The package root: the curated Contract, Akuma, Akumas, Task, Kanshi, World,
+ * The package root: the curated Contract, Akuma, Akumas, Debt, Kanshi, World,
  * Settings, and Plugin surfaces. Internal composition, execution, and
  * configuration helpers stay off this entry; only CLI and Body import them.
  */
 export { z } from "zod";
-export { ALLOWED_ACTIONS, Akuma, AkumaBusyError, AkumaDecodeError, AkumaNotBornError, AkumaProviderError, Schema, } from "./akuma/index.js";
-export { kanshi, observeKanshi, selectKanshi, selectRegion } from "./kanshi/index.js";
+export { ALLOWED_ACTIONS, Akuma, AkumaArchetypeError, AkumaBusyError, AkumaDecodeError, AkumaNotBornError, AkumaProviderError, Schema, listArchetypeDefinitions, } from "./akuma/index.js";
+export { kanshi, kanshiCategory, observeKanshi, selectKanshi, selectRegion } from "./kanshi/index.js";
 export { AkumaAddressError, AkumaWorldScopeError, Akumas } from "./library/akumas.js";
 export { nukeKeiyaku as nuke } from "./library/nuke.js";
 export { SettingsError, settings } from "./settings.js";
-export { TASK_RELATION_PREDICATE_FIELDS, TaskAuthorityCorruptionError, Tasks } from "./task/index.js";
+export { DEBT_RELATION_PREDICATE_FIELDS, DebtAuthorityCorruptionError, Debts } from "./debt/index.js";
 export { World, WorldError } from "./world.js";

package/build/src/kanshi/index.d.ts

@@ -1,5 +1,5 @@
 export { kanshi, kanshiCategory, observeKanshi } from "./read.js";
 export { selectKanshi, selectRegion } from "./select.js";
-export type { KanshiInput } from "./read.js";
-export type { AkumaKanshiRow, AkumaKanshiWorld, ContractEndpointObservation, ContractHolderObservation, ContractKanshiBoard, ContractKanshiRow, KanshiCategoryReport, KanshiReport, Section, TaskKanshiRow, TaskKanshiWorld, KanshiRegionSelection, RegionDeclaration, RegionOverlap, RegionRead, } from "./report.js";
+export type { KanshiCategoryInput, KanshiInput } from "./read.js";
+export type { AkumaKanshiRow, AkumaKanshiWorld, ContractEndpointObservation, ContractHolderObservation, ContractKanshiBoard, ContractKanshiRow, KanshiCategoryReport, KanshiReport, Section, DebtKanshiRow, DebtKanshiWorld, KanshiRegionSelection, RegionDeclaration, RegionOverlap, RegionRead, } from "./report.js";
 export type { KanshiSelection } from "./select.js";

package/build/src/kanshi/read.js

@@ -10,10 +10,10 @@ import { Repo, scopeForRepo } from "../library/repo.js";
 import { readDocuments } from "../protocol/read/documents.js";
 import { observeCurrentPhysicalIssue } from "../protocol/read/observation.js";
 import { readContractBoard, readContractCatalogue, readContractPhase } from "../protocol/read/status.js";
-import { readTaskHolderProjectionAt } from "../settlement/holder.js";
-import { contractNamespace } from "../task/identity.js";
-import { observeRecentTaskStatus, TaskAuthorityCorruptionError } from "../task/index.js";
-import { observeTaskBoard } from "../task/operations.js";
+import { readDebtHolderProjectionAt } from "../settlement/holder.js";
+import { contractNamespace } from "../debt/identity.js";
+import { observeRecentDebtStatus, DebtAuthorityCorruptionError } from "../debt/index.js";
+import { observeDebtBoard } from "../debt/operations.js";
 import { ROSTER_SNAPSHOT_ROWS, ROSTER_VISIBLE_ROWS } from "./roster.js";
 import { selectKanshi, selectRegion } from "./select.js";
 const WORLD_CONTRACT_ROWS = 10;
@@ -89,6 +89,12 @@ function regionSelection(value) {
     }
     throw new TypeError(`kanshi region selection kind is invalid: ${selection.kind}`);
 }
+function worldCoordinate(world, repo) {
+    if (world !== null && (typeof world !== "string" || world.trim().length === 0))
+        throw new TypeError("kanshi world must be a WorldRoot or null");
+    if (repo !== undefined && !(repo instanceof Repo))
+        throw new TypeError("kanshi repo must be a Repo");
+}
 function coordinate(input) {
     if (typeof input !== "object" || input === null || Array.isArray(input))
         throw new TypeError("kanshi input must be an object");
@@ -97,11 +103,7 @@ function coordinate(input) {
             throw new TypeError(`kanshi input has unknown field: ${key}`);
         }
     }
-    if (input.world !== null && (typeof input.world !== "string" || input.world.trim().length === 0)) {
-        throw new TypeError("kanshi world must be a WorldRoot or null");
-    }
-    if (input.repo !== undefined && !(input.repo instanceof Repo))
-        throw new TypeError("kanshi repo must be a Repo");
+    worldCoordinate(input.world, input.repo);
     return {
         ...input,
         ...(input.region === undefined ? {} : { region: regionSelection(input.region) }),
@@ -144,7 +146,7 @@ async function readContracts(observation, include, limit = WORLD_CONTRACT_ROWS)
 }
 async function readHolders(observation) {
     try {
-        return { kind: "present", value: await readTaskHolderProjectionAt(observation) };
+        return { kind: "present", value: await readDebtHolderProjectionAt(observation) };
     }
     catch (error) {
         return { kind: "failed", failure: { message: diagnostic(error) } };
@@ -171,7 +173,7 @@ function attachRoster(contracts, akuma) {
         },
     };
 }
-function decorateContracts(contracts, holders, namespaceTasks) {
+function decorateContracts(contracts, holders, namespaceDebts) {
     if (contracts.kind !== "present")
         return contracts;
     return {
@@ -179,22 +181,22 @@ function decorateContracts(contracts, holders, namespaceTasks) {
         value: {
             ...contracts.value,
             rows: contracts.value.rows.map((row) => {
-                const selected = namespaceTasks?.(row.id);
+                const selected = namespaceDebts?.(row.id);
                 if (holders.kind === "failed") {
                     return {
                         ...row,
                         holder: { kind: "unavailable" },
                         roster: [],
-                        ...(selected === undefined ? {} : { namespaceTasks: selected }),
+                        ...(selected === undefined ? {} : { namespaceDebts: selected }),
                     };
                 }
                 const holder = holders.kind === "present" ? holders.value.get(row.id) : undefined;
                 return {
                     ...row,
                     roster: [],
-                    ...(selected === undefined ? {} : { namespaceTasks: selected }),
+                    ...(selected === undefined ? {} : { namespaceDebts: selected }),
                     holder: holder?.disposition === "held"
-                        ? { kind: "held", taskId: holder.taskId }
+                        ? { kind: "held", debtId: holder.debtId }
                         : { kind: "none" },
                 };
             }),
@@ -212,11 +214,11 @@ function contractEndpointObserver(contracts) {
         return "hasMore" in contracts.value ? "unavailable" : "missing";
     };
 }
-function joinTasks(rows, holders, observeContract) {
+function joinDebts(rows, holders, observeContract) {
     const associations = new Map(holders.kind === "present"
         ? [...holders.value.values()]
             .filter((holder) => holder.disposition === "held")
-            .map((holder) => [holder.taskId, holder.contractId])
+            .map((holder) => [holder.debtId, holder.contractId])
         : []);
     return rows.map((row) => {
         const contractId = associations.get(row.id);
@@ -225,43 +227,43 @@ function joinTasks(rows, holders, observeContract) {
         return { ...row, contract: { id: contractId, observed: observeContract(contractId) } };
     });
 }
-/** Attribute a Task board failure to the malformed document that caused it, when one is known. */
-function taskFailure(error) {
+/** Attribute a Debt board failure to the malformed document that caused it, when one is known. */
+function debtFailure(error) {
     return {
         message: diagnostic(error),
-        ...(error instanceof TaskAuthorityCorruptionError && error.coordinate !== undefined
+        ...(error instanceof DebtAuthorityCorruptionError && error.coordinate !== undefined
             ? { coordinate: error.coordinate }
             : {}),
     };
 }
-async function readTaskWorld(path) {
+async function readDebtWorld(path) {
     if (path === null)
         return { kind: "absent" };
     try {
-        return { kind: "present", observation: await observeTaskBoard(path) };
+        return { kind: "present", observation: await observeDebtBoard(path) };
     }
     catch (error) {
-        return { kind: "failed", failure: taskFailure(error) };
+        return { kind: "failed", failure: debtFailure(error) };
     }
 }
 /**
- * A selected Contract's own Task namespace view. A failed Task board is reported once by the
- * board's Task section, so the entity block omits it rather than repeating the same row.
+ * A selected Contract's own Debt namespace view. A failed Debt board is reported once by the
+ * board's Debt section, so the entity block omits it rather than repeating the same row.
  */
-function namespaceTaskSection(board, id) {
+function namespaceDebtSection(board, id) {
     if (board.kind === "absent")
         return { kind: "absent" };
     if (board.kind === "failed")
         return undefined;
     return { kind: "present", value: board.observation.selectNamespace(contractNamespace(id)) };
 }
-async function readTasks(path, holders, observeContract) {
+async function readDebts(path, holders, observeContract) {
     if (holders.kind === "failed")
         return { kind: "failed", failure: holders.failure };
-    return observeRecentTaskStatus(path, { limit: 10 }).then((recent) => ({
+    return observeRecentDebtStatus(path, { limit: 10 }).then((recent) => ({
         kind: "present",
-        value: { root: path, hasMore: recent.hasMore, rows: joinTasks(recent.rows, holders, observeContract) },
-    }), (error) => ({ kind: "failed", failure: taskFailure(error) }));
+        value: { root: path, hasMore: recent.hasMore, rows: joinDebts(recent.rows, holders, observeContract) },
+    }), (error) => ({ kind: "failed", failure: debtFailure(error) }));
 }
 /**
  * Placement discharge for the observed roster snapshots: an associated Contract
@@ -355,7 +357,7 @@ async function observeWithoutRepo(world, region, observedAt, branch) {
     const contracts = { kind: "absent" };
     const holders = { kind: "absent" };
     const observeContract = contractEndpointObserver(contracts);
-    const tasks = world === null ? { kind: "absent" } : await readTasks(world, holders, observeContract);
+    const debts = world === null ? { kind: "absent" } : await readDebts(world, holders, observeContract);
     const aliases = world === null ? { kind: "absent" } : await readAliasBindings(world);
     const akuma = world === null
         ? { kind: "absent" }
@@ -366,7 +368,7 @@ async function observeWithoutRepo(world, region, observedAt, branch) {
             observedAt,
             branch,
             contracts,
-            tasks,
+            debts,
             akuma,
             ...(region === undefined ? {} : { region: { kind: "absent" } }),
         },
@@ -386,11 +388,11 @@ async function observeRepo(input) {
             const selectedContract = contract !== undefined &&
                 contractSection.kind === "present" &&
                 contractSection.value.rows.some((row) => row.id === contract);
-            const board = selectedContract ? await readTaskWorld(world) : undefined;
-            const contracts = decorateContracts(contractSection, holders, selectedContract ? (id) => (id === contract ? namespaceTaskSection(board, id) : undefined) : undefined);
+            const board = selectedContract ? await readDebtWorld(world) : undefined;
+            const contracts = decorateContracts(contractSection, holders, selectedContract ? (id) => (id === contract ? namespaceDebtSection(board, id) : undefined) : undefined);
             const observeContract = contractEndpointObserver(contracts);
             const aliases = world === null ? { kind: "absent" } : await readAliasBindings(world);
-            const tasks = world === null ? { kind: "absent" } : await readTasks(world, holders, observeContract);
+            const debts = world === null ? { kind: "absent" } : await readDebts(world, holders, observeContract);
             const claimed = dispatches.kind === "present"
                 ? await claimedAssociatedContracts(observation, dispatches.value)
                 : new Set();
@@ -404,7 +406,7 @@ async function observeRepo(input) {
                 observedAt,
                 branch,
                 contracts: attachRoster(contracts, akuma),
-                tasks,
+                debts,
                 akuma,
                 ...(regionSection === undefined ? {} : { region: regionSection }),
             };
@@ -428,7 +430,7 @@ async function observeRepo(input) {
                 observedAt,
                 branch,
                 contracts: failure,
-                tasks: world === null ? { kind: "absent" } : failure,
+                debts: world === null ? { kind: "absent" } : failure,
                 akuma: world === null ? { kind: "absent" } : failure,
                 ...(region === undefined ? {} : { region: failure }),
             },
@@ -447,7 +449,7 @@ export async function observeKanshi(input) {
 export async function kanshi(input) {
     return (await observeKanshi(input)).report;
 }
-/** Category observations reuse owner rows without reading the Task board. */
+/** Category observations reuse owner rows without reading the Debt board. */
 async function observeAkumaCategory(world, repo, limit, observedAt) {
     const report = (akuma) => ({
         category: "akuma",
@@ -498,9 +500,22 @@ async function observeContractCategory(world, repo, limit, observedAt) {
         return report({ kind: "failed", failure: { message: diagnostic(error) } });
     }
 }
+const DEFAULT_CATEGORY_LIMIT = 10;
+/** Caller-invalid category requests are refused here, before any owner observation runs. */
+function validateCategoryInput(input) {
+    const value = record(input, "category input");
+    exactKeys(value, ["world", "repo", "category", "limit"], "category input");
+    worldCoordinate(value.world, value.repo);
+    if (value.category !== "akuma" && value.category !== "contract")
+        throw new TypeError(`kanshi category is invalid: ${String(value.category)}`);
+    const { limit } = value;
+    if (limit !== undefined && (typeof limit !== "number" || !Number.isSafeInteger(limit) || limit < 1))
+        throw new TypeError("kanshi category limit must be a positive safe integer");
+}
 export async function kanshiCategory(input) {
     const observedAt = new Date().toISOString();
-    const { world, repo, category, limit = 10 } = input;
+    validateCategoryInput(input);
+    const { world, repo, category, limit = DEFAULT_CATEGORY_LIMIT } = input;
     if (category === "contract") {
         if (repo === undefined)
             throw new TypeError("kanshi contract category requires a Repo");

package/build/src/kanshi/report.d.ts

@@ -6,7 +6,7 @@ import type { ContractId } from "../index.js";
 import type { RegionOverlap } from "../library/region.js";
 import type { CurrentPhysicalIssue } from "../protocol/read/observation.js";
 import type { ContractBoard, ContractDisposition, ContractPhase } from "../protocol/read/status.js";
-import type { TaskId, TaskRef, TaskRow } from "../task/index.js";
+import type { DebtId, DebtRef, DebtRow } from "../debt/index.js";
 import type { WorldRoot } from "../world.js";
 export type { RegionOverlap };
 export type Section<Value> = Readonly<{
@@ -24,7 +24,7 @@ export type Section<Value> = Readonly<{
 export type ContractEndpointObservation = ContractDisposition | "missing" | "unavailable";
 export type ContractHolderObservation = Readonly<{
     kind: "held";
-    taskId: TaskId;
+    debtId: DebtId;
 }> | Readonly<{
     kind: "none";
 }> | Readonly<{
@@ -38,21 +38,21 @@ export type ContractKanshiRow = ContractBoard["rows"][number] & Readonly<{
     phase: ContractPhase;
     holder: ContractHolderObservation;
     roster: readonly ContractRosterAttachment[];
-    namespaceTasks?: Section<readonly TaskRow[]>;
+    namespaceDebts?: Section<readonly DebtRow[]>;
     issue?: CurrentPhysicalIssue;
 }>;
 export type ContractKanshiBoard = Omit<ContractBoard, "rows"> & Readonly<{
     rows: readonly ContractKanshiRow[];
     hasMore?: boolean;
 }>;
-export type TaskKanshiRow = TaskRow & Readonly<{
+export type DebtKanshiRow = DebtRow & Readonly<{
     contract?: Readonly<{
         id: string;
         observed: ContractEndpointObservation;
     }>;
-    blockers?: readonly TaskRef[];
+    blockers?: readonly DebtRef[];
 }>;
-export type TaskKanshiWorld = BoundedList<TaskKanshiRow> & Readonly<{
+export type DebtKanshiWorld = BoundedList<DebtKanshiRow> & Readonly<{
     root: WorldRoot;
 }>;
 export type AkumaKanshiRow = (AkumaListRow | UnbornAkumaListRow) & Readonly<{
@@ -96,7 +96,7 @@ export type KanshiReport = Readonly<{
     observedAt: string;
     branch: string | null;
     contracts: Section<ContractKanshiBoard>;
-    tasks: Section<TaskKanshiWorld>;
+    debts: Section<DebtKanshiWorld>;
     akuma: Section<AkumaKanshiWorld>;
     region?: Section<RegionRead>;
 }>;

package/build/src/kanshi/select.js

@@ -29,15 +29,15 @@ export function selectKanshi(input) {
                 },
             }
             : report.contracts,
-        tasks: report.tasks.kind === "present"
+        debts: report.debts.kind === "present"
             ? {
                 kind: "present",
                 value: {
-                    ...report.tasks.value,
-                    rows: report.tasks.value.rows.filter((row) => row.contract?.id === contract),
+                    ...report.debts.value,
+                    rows: report.debts.value.rows.filter((row) => row.contract?.id === contract),
                 },
             }
-            : report.tasks,
+            : report.debts,
         akuma: report.akuma.kind === "present"
             ? {
                 kind: "present",

package/build/src/library/address.js

@@ -7,6 +7,7 @@ import { contractId } from "../core/facts/types.js";
 import { readDispatches } from "../dispatch/index.js";
 import { matchesAkumaGlob, parseReadableAkumaAlias, parseAkumaGlob, } from "../identity/selector.js";
 import { World } from "../world.js";
+import { matchContractCandidates } from "./contract-address.js";
 import { requireInput } from "./input.js";
 import { scopeForRepo } from "./repo.js";
 export class AkumaAddressError extends Error {
@@ -69,10 +70,7 @@ export function resolveNamedAddress(input) {
     if (selector.startsWith("aku/"))
         return { kind: "akuma", id: parseAddressId(selector).id };
     const alias = parseAddressAlias(selector);
-    const contractMatches = (input.report.contracts.kind === "present" ? input.report.contracts.value.rows : []).filter((row) => row.disposition === "active" &&
-        row.workspace === "worktree" &&
-        row.worktreePath !== null &&
-        `@${row.id.slice("kei/".length)}` === alias);
+    const contractMatches = matchContractCandidates(input.report.contracts.kind === "present" ? input.report.contracts.value.rows : [], { selector: alias });
     const aliasId = input.aliases.kind === "present"
         ? (input.aliases.value.find((binding) => binding.alias === alias)?.akuId ?? null)
         : null;

package/build/src/library/akuma-creation.d.ts

@@ -1,3 +1,4 @@
+import { type AkumaCaller } from "../akuma/caller.js";
 import { type ForkReceipt } from "../akuma/akuma-owner.js";
 import { type AskObserver } from "../akuma/akuma-selection-execution.js";
 import type { AkumaStatus } from "../akuma/akuma.js";
@@ -63,6 +64,7 @@ export type CallInput = Readonly<{
     allowed?: readonly AllowedAction[];
     schema?: Schema<unknown>;
     initiator?: string;
+    caller?: AkumaCaller;
     signal?: AbortSignal;
     observe?: CallWaitObserver;
 }>;
@@ -98,6 +100,8 @@ export type ForkInput = Readonly<{
     akuma: string;
     at: string;
     repo?: Repo;
+    caller?: AkumaCaller;
+    initiator?: string;
 }>;
 export type ForkResult = Readonly<{
     kind: "forked";
@@ -112,7 +116,7 @@ export type ForkResult = Readonly<{
 }>);
 export declare function callAkumas(input: CallInput & Readonly<{
     path: WorldRoot;
-}>, execution?: ExecutionContext): Promise<CallResult>;
+}>, execution?: ExecutionContext, reportDiagnostic?: (message: string) => void): Promise<CallResult>;
 export declare function forkAkumas(input: ForkInput & Readonly<{
     path: WorldRoot;
 }>): Promise<ForkResult>;