cclaw-cli 7.7.1 → 8.1.0

package/dist/content/hook-manifest.js

@@ -1,156 +0,0 @@
-/**
- * Canonical operational manifest for cclaw hooks.
- *
- * This is the **single source of truth** for:
- *
- *  - the per-harness JSON generators in `./observe.ts`
- *    (claude/cursor/codex hook documents),
- *  - the semantic coverage map in `./hook-events.ts` (docs + sync/runtime checks),
- *  - the `requiredEvents` list embedded in `src/hook-schemas/*.v1.json`
- *    (enforced by a parity test).
- *
- * When adding a new hook handler or rerouting an existing one, edit
- * this file and let the downstream modules rebuild from it. Never
- * hard-code a `SessionStart`, `PreToolUse`, etc. mapping outside of
- * this manifest.
- *
- * OpenCode is deliberately out of scope here: its plugin
- * (`opencode-plugin.ts`) implements the handlers inline rather than
- * dispatching through `run-hook.mjs`, so its coverage is tracked
- * separately in `HOOK_EVENTS_BY_HARNESS`.
- */
-export const HOOK_MANIFEST_HARNESSES = ["claude", "cursor", "codex"];
-export const HOOK_HANDLERS = [
-    "session-start",
-    "stop-handoff"
-];
-export const HOOK_SEMANTIC_EVENTS = [
-    "session_rehydrate",
-    "stop_handoff"
-];
-export const HOOK_MANIFEST = [
-    {
-        handler: "session-start",
-        description: "Rehydrate flow state and emit bootstrap digest.",
-        semantic: "session_rehydrate",
-        bindings: {
-            claude: [{ event: "SessionStart", matcher: "startup|resume|clear|compact" }],
-            cursor: [
-                { event: "sessionStart" },
-                { event: "sessionResume" },
-                { event: "sessionClear" },
-                { event: "sessionCompact" }
-            ],
-            codex: [
-                {
-                    event: "SessionStart",
-                    matcher: "startup|resume",
-                    statusMessage: "Running cclaw session startup checks"
-                }
-            ]
-        }
-    },
-    {
-        handler: "stop-handoff",
-        description: "Remind about clean handoff with stage + run context on session stop.",
-        semantic: "stop_handoff",
-        bindings: {
-            claude: [{ event: "Stop", timeout: 10 }],
-            cursor: [{ event: "stop", timeout: 10 }],
-            codex: [
-                {
-                    event: "Stop",
-                    timeout: 10,
-                    statusMessage: "Preparing cclaw handoff checklist"
-                }
-            ]
-        }
-    }
-];
-/** Sanity: every harness in HOOK_MANIFEST_HARNESSES must be a HarnessId. */
-const _harnessIdCheck = HOOK_MANIFEST_HARNESSES;
-void _harnessIdCheck;
-/**
- * Group manifest bindings by harness-native event name. This is the
- * core projection that observe.ts generators consume to emit the
- * harness-specific JSON document.
- */
-export function groupBindingsByEvent(harness) {
-    const order = [];
-    const byEvent = new Map();
-    let seq = 0;
-    for (const spec of HOOK_MANIFEST) {
-        const bindings = spec.bindings[harness];
-        if (!bindings)
-            continue;
-        for (const binding of bindings) {
-            let group = byEvent.get(binding.event);
-            if (!group) {
-                group = { event: binding.event, entries: [] };
-                byEvent.set(binding.event, group);
-                order.push(binding.event);
-            }
-            group.entries.push({
-                handler: spec.handler,
-                ...(binding.matcher !== undefined ? { matcher: binding.matcher } : {}),
-                ...(binding.timeout !== undefined ? { timeout: binding.timeout } : {}),
-                ...(binding.statusMessage !== undefined ? { statusMessage: binding.statusMessage } : {}),
-                priority: binding.priority ?? 0,
-                seq: seq++
-            });
-        }
-    }
-    return order.map((event) => {
-        const group = byEvent.get(event);
-        const sorted = [...group.entries].sort((a, b) => {
-            if (a.priority !== b.priority)
-                return a.priority - b.priority;
-            return a.seq - b.seq;
-        });
-        return {
-            event: group.event,
-            entries: sorted.map(({ priority: _p, seq: _s, ...entry }) => entry)
-        };
-    });
-}
-/** Distinct harness-native event names covered by the manifest. */
-export function requiredEventsFor(harness) {
-    const seen = new Set();
-    const ordered = [];
-    for (const spec of HOOK_MANIFEST) {
-        for (const binding of spec.bindings[harness] ?? []) {
-            if (seen.has(binding.event))
-                continue;
-            seen.add(binding.event);
-            ordered.push(binding.event);
-        }
-    }
-    return ordered;
-}
-/**
- * Human-readable per-harness semantic coverage used by docs and sync/runtime diagnostics.
- */
-export function semanticEventCoverage(harness) {
-    const out = {};
-    for (const spec of HOOK_MANIFEST) {
-        if (spec.semantic === null)
-            continue;
-        const bindings = spec.bindings[harness];
-        if (!bindings || bindings.length === 0)
-            continue;
-        out[spec.semantic] = describeBindings(bindings);
-    }
-    return out;
-}
-function describeBindings(bindings) {
-    return bindings
-        .map((binding) => {
-        const pieces = [binding.event];
-        if (binding.matcher)
-            pieces.push(`matcher=${binding.matcher}`);
-        if (binding.timeout)
-            pieces.push(`timeout=${binding.timeout}s`);
-        return pieces.join(" ");
-    })
-        .join(" | ");
-}

package/dist/content/hooks.d.ts

@@ -1,11 +0,0 @@
-export declare function startFlowScript(): string;
-export declare function cancelRunScript(): string;
-export declare function stageCompleteScript(): string;
-export declare function delegationRecordScript(): string;
-export declare function sliceCommitScript(): string;
-export declare function runHookCmdScript(): string;
-export { claudeHooksJsonWithObservation as claudeHooksJson } from "./observe.js";
-export { cursorHooksJsonWithObservation as cursorHooksJson } from "./observe.js";
-export { codexHooksJsonWithObservation as codexHooksJson } from "./observe.js";
-export { nodeHookRuntimeScript } from "./node-hooks.js";
-export { opencodePluginJs } from "./opencode-plugin.js";