@thomas-powers-jr/cadence-host-toolkit 1.54.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Powers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/install-merge.d.ts

@@ -0,0 +1,37 @@
+export interface ManagedHookEntry {
+    matcher?: string;
+    hooks: Array<{
+        type: 'command';
+        command: string;
+    }>;
+    _managedBy?: string;
+}
+/**
+ * True when a hook entry carries CADENCE's own managed marker
+ * (`_managedBy: 'cadence'`). This is the JSON-hook-entry analog of the
+ * `<!-- managed-by: cadence -->` marker used for the rendered slash-command
+ * files (`install-commands.ts`, out of scope here) — the shared convention
+ * both host adapters use to tell "cadence installed and owns this" apart
+ * from "the user (or a third-party tool) put this here, leave it alone."
+ */
+export declare function isCadenceManagedEntry(entry: ManagedHookEntry): boolean;
+/**
+ * Merge `desired` cadence-managed hook entries into an `existing`
+ * hooks-by-event map.
+ *
+ * For every event key present in `desired`: entries considered "stale" (by
+ * default, any entry already carrying the cadence managed-marker from a
+ * prior install — see {@link isCadenceManagedEntry}) are evicted, and the
+ * fresh `desired` entries for that event are appended. Anything else on that
+ * event — a user-authored or third-party hook — is preserved untouched.
+ * Event keys present only in `existing` (not part of this install) are left
+ * exactly as they were.
+ *
+ * `isStale` is overridable so an adapter can additionally evict its own
+ * legacy markers alongside the current cadence one (e.g. host-claude-code's
+ * pre-rename `_managedBy: 'keel'` entries — Phase 18.1's F2 rename rollout).
+ *
+ * Pure: does not mutate `existing` or `desired`; returns a new map.
+ */
+export declare function mergeManagedHookEntries(existing: Record<string, ManagedHookEntry[]>, desired: Record<string, ManagedHookEntry[]>, isStale?: (entry: ManagedHookEntry) => boolean): Record<string, ManagedHookEntry[]>;
+//# sourceMappingURL=install-merge.d.ts.map

package/dist/install-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-merge.d.ts","sourceRoot":"","sources":["../src/install-merge.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAC3C,OAAO,GAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAA+B,GACpE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAOpC"}

package/dist/install-merge.js

@@ -0,0 +1,38 @@
+/**
+ * True when a hook entry carries CADENCE's own managed marker
+ * (`_managedBy: 'cadence'`). This is the JSON-hook-entry analog of the
+ * `<!-- managed-by: cadence -->` marker used for the rendered slash-command
+ * files (`install-commands.ts`, out of scope here) — the shared convention
+ * both host adapters use to tell "cadence installed and owns this" apart
+ * from "the user (or a third-party tool) put this here, leave it alone."
+ */
+export function isCadenceManagedEntry(entry) {
+    return entry._managedBy === 'cadence';
+}
+/**
+ * Merge `desired` cadence-managed hook entries into an `existing`
+ * hooks-by-event map.
+ *
+ * For every event key present in `desired`: entries considered "stale" (by
+ * default, any entry already carrying the cadence managed-marker from a
+ * prior install — see {@link isCadenceManagedEntry}) are evicted, and the
+ * fresh `desired` entries for that event are appended. Anything else on that
+ * event — a user-authored or third-party hook — is preserved untouched.
+ * Event keys present only in `existing` (not part of this install) are left
+ * exactly as they were.
+ *
+ * `isStale` is overridable so an adapter can additionally evict its own
+ * legacy markers alongside the current cadence one (e.g. host-claude-code's
+ * pre-rename `_managedBy: 'keel'` entries — Phase 18.1's F2 rename rollout).
+ *
+ * Pure: does not mutate `existing` or `desired`; returns a new map.
+ */
+export function mergeManagedHookEntries(existing, desired, isStale = isCadenceManagedEntry) {
+    const merged = { ...existing };
+    for (const [event, entries] of Object.entries(desired)) {
+        const kept = (merged[event] ?? []).filter((entry) => !isStale(entry));
+        merged[event] = [...kept, ...entries];
+    }
+    return merged;
+}
+//# sourceMappingURL=install-merge.js.map

package/dist/install-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-merge.js","sourceRoot":"","sources":["../src/install-merge.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAuB;IAC3D,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA4C,EAC5C,OAA2C,EAC3C,UAAgD,qBAAqB;IAErE,MAAM,MAAM,GAAuC,EAAE,GAAG,QAAQ,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/locate-self.d.ts

@@ -0,0 +1,23 @@
+export interface LocalPaths {
+    /** Absolute path to a host adapter's compiled CLI entry (dist/cli.js). */
+    shimCli: string;
+    /** Absolute path to the workspace @thomas-powers-jr/cadence-core CLI entry (dist/cli/index.js). */
+    coreCli: string;
+}
+/**
+ * Resolves absolute paths to the local (workspace) builds of a host adapter
+ * and `@thomas-powers-jr/cadence-core`, given the URL of a module living at that
+ * adapter's own package root (i.e. `packages/<adapter>/src/locate-self.ts` or
+ * `packages/<adapter>/dist/locate-self.js`). Designed to work both at runtime
+ * (compiled, running from `dist/`) and under vitest (running from `src/`).
+ *
+ * Shared by every host adapter (phase 222 — formerly duplicated verbatim in
+ * `host-claude-code/src/locate-self.ts` and `host-codex/src/locate-self.ts`).
+ * This works across adapters because every adapter package lives at the same
+ * depth under `packages/`, so the relative hop up to
+ * `packages/core/dist/cli/index.js` is identical regardless of which adapter
+ * is asking — the caller only needs to supply *its own* `import.meta.url` so
+ * the function anchors to the right adapter directory.
+ */
+export declare function resolveAdapterLocalPaths(adapterModuleUrl: string): LocalPaths;
+//# sourceMappingURL=locate-self.d.ts.map

package/dist/locate-self.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate-self.d.ts","sourceRoot":"","sources":["../src/locate-self.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAQ7E"}

package/dist/locate-self.js

@@ -0,0 +1,27 @@
+import { basename, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolves absolute paths to the local (workspace) builds of a host adapter
+ * and `@thomas-powers-jr/cadence-core`, given the URL of a module living at that
+ * adapter's own package root (i.e. `packages/<adapter>/src/locate-self.ts` or
+ * `packages/<adapter>/dist/locate-self.js`). Designed to work both at runtime
+ * (compiled, running from `dist/`) and under vitest (running from `src/`).
+ *
+ * Shared by every host adapter (phase 222 — formerly duplicated verbatim in
+ * `host-claude-code/src/locate-self.ts` and `host-codex/src/locate-self.ts`).
+ * This works across adapters because every adapter package lives at the same
+ * depth under `packages/`, so the relative hop up to
+ * `packages/core/dist/cli/index.js` is identical regardless of which adapter
+ * is asking — the caller only needs to supply *its own* `import.meta.url` so
+ * the function anchors to the right adapter directory.
+ */
+export function resolveAdapterLocalPaths(adapterModuleUrl) {
+    const here = dirname(fileURLToPath(adapterModuleUrl));
+    const distDir = basename(here) === 'src' ? resolve(here, '..', 'dist') : here;
+    const adapterRoot = resolve(distDir, '..');
+    return {
+        shimCli: resolve(distDir, 'cli.js'),
+        coreCli: resolve(adapterRoot, '..', 'core', 'dist', 'cli', 'index.js'),
+    };
+}
+//# sourceMappingURL=locate-self.js.map

package/dist/locate-self.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate-self.js","sourceRoot":"","sources":["../src/locate-self.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CAAC,gBAAwB;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;QACnC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/routing.d.ts

@@ -0,0 +1,43 @@
+import type { AbstractEvent, ExtractedPayload } from '@thomas-powers-jr/cadence-types';
+export type { ExtractedPayload };
+export declare const EDIT_TOOL_MATCHER = "Edit|Write|MultiEdit|NotebookEdit";
+export declare const SKILL_TOOL_MATCHER = "Skill";
+/**
+ * Map a host hook event name to its cadence abstract event. `toolName`
+ * disambiguates `PostToolUse` between the edit-tool flow (post-tool-edit)
+ * and the Skill-tool flow (skill-invoke, Phase 23.4).
+ */
+export declare function mapEvent(hostEvent: string, toolName?: string): AbstractEvent | null;
+export declare function extractPayload(raw: unknown): ExtractedPayload | undefined;
+export interface RouteResult {
+    abstractEvent: AbstractEvent | null;
+    translatedStdin: string;
+}
+/**
+ * Translate one host stdin-JSON hook event into a cadence abstract event plus
+ * the stdin the core dispatcher should receive. The 8-step algorithm: parse
+ * JSON (1), reject non-object/array payloads (2), require a string
+ * `hook_event_name` (3), read `tool_name` (4), map the event — with the Skill
+ * disambiguation (5), bail out on an unmapped event (6), defensively re-filter
+ * Pre/PostToolUse to known edit tools (7), then extract + translate the
+ * payload (8). Unmapped events, malformed JSON, and Pre/PostToolUse for
+ * non-edit tools return `{ abstractEvent: null }` with the raw stdin passed
+ * through untouched (the core never sees them).
+ */
+export declare function routeHookEvent(raw: string): RouteResult;
+export interface CommandSpec {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    cli: string;
+    trailing?: string;
+    /**
+     * Multi-line prompt body rendered after the auto-run command line. Used by
+     * dialogue commands (e.g. cadence-scout, cadence-dispatch) that are a
+     * prompt template rather than a thin CLI shell-out. Thin commands leave
+     * this unset.
+     */
+    body?: string;
+}
+export declare const COMMANDS: CommandSpec[];
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAKvF,YAAY,EAAE,gBAAgB,EAAE,CAAC;AASjC,eAAO,MAAM,iBAAiB,sCAAsC,CAAC;AACrE,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAY1C;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGnF;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAqCzE;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwCvD;AAaD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAQD,eAAO,MAAM,QAAQ,EAAE,WAAW,EAsGjC,CAAC"}

package/dist/routing.js

@@ -0,0 +1,226 @@
+import { COMMAND_GUIDANCE, DISPATCH_DIALOGUE, SCOUT_DIALOGUE } from '@thomas-powers-jr/cadence-types';
+// ---------------------------------------------------------------------------
+// Hook-event routing (formerly duplicated in each adapter's event-map.ts /
+// shim.ts). Both host-claude-code and host-codex receive Claude-Code-shaped
+// hook JSON on stdin and translate it into a cadence AbstractEvent — this is
+// the one shared implementation of that 8-step dispatch algorithm.
+// ---------------------------------------------------------------------------
+export const EDIT_TOOL_MATCHER = 'Edit|Write|MultiEdit|NotebookEdit';
+export const SKILL_TOOL_MATCHER = 'Skill';
+const EVENT_TABLE = {
+    SessionStart: 'session-start',
+    UserPromptSubmit: 'user-prompt',
+    PreToolUse: 'pre-tool-edit',
+    PostToolUse: 'post-tool-edit',
+    Stop: 'session-stop',
+    SubagentStop: 'subagent-result',
+    SubagentStart: 'subagent-start',
+};
+/**
+ * Map a host hook event name to its cadence abstract event. `toolName`
+ * disambiguates `PostToolUse` between the edit-tool flow (post-tool-edit)
+ * and the Skill-tool flow (skill-invoke, Phase 23.4).
+ */
+export function mapEvent(hostEvent, toolName) {
+    if (hostEvent === 'PostToolUse' && toolName === 'Skill')
+        return 'skill-invoke';
+    return EVENT_TABLE[hostEvent] ?? null;
+}
+const EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+export function extractPayload(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const r = raw;
+    const agentId = typeof r.agent_id === 'string' && r.agent_id.length > 0 ? r.agent_id : undefined;
+    const agentType = typeof r.agent_type === 'string' && r.agent_type.length > 0 ? r.agent_type : undefined;
+    const agentFields = { ...(agentId ? { agentId } : {}), ...(agentType ? { agentType } : {}) };
+    if (r.hook_event_name !== 'PreToolUse' && r.hook_event_name !== 'PostToolUse') {
+        // SubagentStart/SubagentStop (and any other future event) only ever
+        // carry agent fields — no files/skill to extract.
+        return Object.keys(agentFields).length > 0 ? agentFields : undefined;
+    }
+    if (!r.tool_name)
+        return Object.keys(agentFields).length > 0 ? agentFields : undefined;
+    // Skill tool: extract skill name (Phase 23.4).
+    if (r.tool_name === 'Skill') {
+        const s = r.tool_input?.skill;
+        if (typeof s !== 'string' || s.length === 0) {
+            return Object.keys(agentFields).length > 0 ? agentFields : undefined;
+        }
+        return { skill: s, ...agentFields };
+    }
+    // Edit tools: extract file path.
+    if (!EDIT_TOOLS.has(r.tool_name)) {
+        return Object.keys(agentFields).length > 0 ? agentFields : undefined;
+    }
+    const fp = r.tool_input?.file_path;
+    if (typeof fp !== 'string' || fp.length === 0) {
+        return Object.keys(agentFields).length > 0 ? agentFields : undefined;
+    }
+    return { files: [fp], ...agentFields };
+}
+/**
+ * Translate one host stdin-JSON hook event into a cadence abstract event plus
+ * the stdin the core dispatcher should receive. The 8-step algorithm: parse
+ * JSON (1), reject non-object/array payloads (2), require a string
+ * `hook_event_name` (3), read `tool_name` (4), map the event — with the Skill
+ * disambiguation (5), bail out on an unmapped event (6), defensively re-filter
+ * Pre/PostToolUse to known edit tools (7), then extract + translate the
+ * payload (8). Unmapped events, malformed JSON, and Pre/PostToolUse for
+ * non-edit tools return `{ abstractEvent: null }` with the raw stdin passed
+ * through untouched (the core never sees them).
+ */
+export function routeHookEvent(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw); // 1. parse
+    }
+    catch {
+        return { abstractEvent: null, translatedStdin: raw };
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        // 2. reject non-object/array payloads
+        return { abstractEvent: null, translatedStdin: raw };
+    }
+    const obj = parsed;
+    if (typeof obj.hook_event_name !== 'string') {
+        // 3. require a string hook_event_name
+        return { abstractEvent: null, translatedStdin: raw };
+    }
+    // 4. read tool_name
+    const toolName = parsed.tool_name;
+    const toolNameStr = typeof toolName === 'string' ? toolName : undefined;
+    // 5. map the event (Skill disambiguation happens inside mapEvent)
+    const abstractEvent = mapEvent(obj.hook_event_name, toolNameStr);
+    if (abstractEvent === null) {
+        // 6. bail out on an unmapped event
+        return { abstractEvent: null, translatedStdin: raw };
+    }
+    // 7. Defensive filter: PreToolUse/PostToolUse for non-edit tools should be
+    // dropped even though the host's own hook matcher already restricts them.
+    // Skill tool takes its own route (skill-invoke) above and bypasses this
+    // filter.
+    if (abstractEvent === 'pre-tool-edit' || abstractEvent === 'post-tool-edit') {
+        if (typeof toolName !== 'string' || !EDIT_TOOLS.has(toolName)) {
+            return { abstractEvent: null, translatedStdin: raw };
+        }
+    }
+    // 8. extract + translate the payload
+    const extracted = extractPayload(parsed);
+    const translated = { ...parsed };
+    if (extracted?.files)
+        translated.files = extracted.files;
+    if (extracted?.skill)
+        translated.skill = extracted.skill;
+    return { abstractEvent, translatedStdin: JSON.stringify(translated) };
+}
+// Guidance prose (description/trailing) + the dialogue bodies live in the
+// shared `@thomas-powers-jr/cadence-types` guidance module (phase 77) so the MCP
+// prompts and these slash commands share one source of truth. The
+// command-shape fields (cli, argumentHint, which commands carry a dialogue
+// body) live here so both host adapters render from the identical catalog.
+const g = COMMAND_GUIDANCE;
+export const COMMANDS = [
+    {
+        name: 'cadence-progress',
+        description: g['cadence-progress'].description,
+        cli: 'progress',
+        trailing: g['cadence-progress'].trailing,
+    },
+    {
+        name: 'cadence-next',
+        description: g['cadence-next'].description,
+        cli: 'next',
+        trailing: g['cadence-next'].trailing,
+    },
+    {
+        name: 'cadence-draft',
+        description: g['cadence-draft'].description,
+        argumentHint: '<phase-id> <task-num> [--title=<title>]',
+        cli: 'draft new $ARGUMENTS',
+        trailing: g['cadence-draft'].trailing,
+    },
+    {
+        name: 'cadence-approve',
+        description: g['cadence-approve'].description,
+        argumentHint: '<phase-id> <task-num>',
+        cli: 'draft approve $ARGUMENTS',
+        trailing: g['cadence-approve'].trailing,
+    },
+    {
+        name: 'cadence-check',
+        description: g['cadence-check'].description,
+        argumentHint: '<phase-id> <task-num>',
+        cli: 'draft check $ARGUMENTS',
+        trailing: g['cadence-check'].trailing,
+    },
+    {
+        name: 'cadence-build',
+        description: g['cadence-build'].description,
+        argumentHint: '<task-id> --status=<PASS|FAIL|BLOCKED|ESCALATED>',
+        cli: 'build task $ARGUMENTS',
+        trailing: g['cadence-build'].trailing,
+    },
+    {
+        name: 'cadence-settle',
+        description: g['cadence-settle'].description,
+        argumentHint: '[--ac AC-1=pass ...]',
+        cli: 'settle run $ARGUMENTS',
+        trailing: g['cadence-settle'].trailing,
+    },
+    {
+        name: 'cadence-done',
+        description: g['cadence-done'].description,
+        argumentHint: '<task-id> [--notes=<n>]',
+        cli: 'done $ARGUMENTS',
+        trailing: g['cadence-done'].trailing,
+    },
+    {
+        name: 'cadence-block',
+        description: g['cadence-block'].description,
+        argumentHint: '<task-id> [--notes=<n>]',
+        cli: 'block $ARGUMENTS',
+        trailing: g['cadence-block'].trailing,
+    },
+    {
+        name: 'cadence-needs-context',
+        description: g['cadence-needs-context'].description,
+        argumentHint: '<task-id> [--notes=<n>]',
+        cli: 'needs-context $ARGUMENTS',
+        trailing: g['cadence-needs-context'].trailing,
+    },
+    {
+        name: 'cadence-handoff',
+        description: g['cadence-handoff'].description,
+        argumentHint: '[label]',
+        cli: 'handoff $ARGUMENTS',
+        trailing: g['cadence-handoff'].trailing,
+    },
+    {
+        name: 'cadence-resume',
+        description: g['cadence-resume'].description,
+        cli: 'resume',
+        trailing: g['cadence-resume'].trailing,
+    },
+    {
+        name: 'cadence-recommend',
+        description: g['cadence-recommend'].description,
+        argumentHint: '[count]',
+        cli: 'recommend --top 5',
+        trailing: g['cadence-recommend'].trailing,
+    },
+    {
+        name: 'cadence-scout',
+        description: g['cadence-scout'].description,
+        argumentHint: '[topic]',
+        cli: 'recommend',
+        body: SCOUT_DIALOGUE,
+    },
+    {
+        name: 'cadence-dispatch',
+        description: g['cadence-dispatch'].description,
+        cli: 'dispatch plan --json',
+        body: DISPATCH_DIALOGUE,
+    },
+];
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@thomas-powers-jr/cadence-host-toolkit",
+  "version": "1.54.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "description": "Shared toolkit for CADENCE host adapters — the hook-event routing algorithm and the slash-command catalog used by host-claude-code and host-codex.",
+  "license": "MIT",
+  "author": "Thomas Powers",
+  "homepage": "https://github.com/thomas-powers-jr/cadence#readme",
+  "bugs": "https://github.com/thomas-powers-jr/cadence/issues",
+  "keywords": [
+    "cadence",
+    "host-adapter",
+    "toolkit",
+    "hooks",
+    "slash-commands"
+  ],
+  "type": "module",
+  "main": "./dist/routing.js",
+  "types": "./dist/routing.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/routing.js",
+      "types": "./dist/routing.d.ts"
+    },
+    "./locate-self": {
+      "import": "./dist/locate-self.js",
+      "types": "./dist/locate-self.d.ts"
+    },
+    "./install-merge": {
+      "import": "./dist/install-merge.js",
+      "types": "./dist/install-merge.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/tsconfig.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thomas-powers-jr/cadence.git",
+    "directory": "packages/host-toolkit"
+  },
+  "dependencies": {
+    "@thomas-powers-jr/cadence-types": "1.54.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "clean": "rm -rf dist .turbo"
+  }
+}