@dezycro-ai/agent-plugin 2.1.2 → 2.2.0

package/dist/hooks/types.d.ts

@@ -1,293 +0,0 @@
-/**
- * types.ts — shared type definitions for Companion V2 hooks.
- *
- * Hook output types match Claude Code's documented schema (captured from
- * the schema error message hit in the V2.0 dogfood — Anthropic does not
- * publish official TS types as of 2026-05). Hook input payload types are
- * partials because Claude Code's payload shape varies per event and we
- * only consume the fields we use.
- *
- * Companion state and config match the on-disk JSON shape in
- * `.dezycro/companion-state.json` and `.dezycro/config.json`.
- */
-export type HookEventName = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop' | 'SessionStart' | 'SessionEnd' | 'PreCompact' | 'Notification' | 'SubagentStop';
-export type Decision = 'approve' | 'block';
-export type PermissionDecision = 'allow' | 'deny' | 'ask' | 'defer';
-/** Fields valid at the top level of every hook output. */
-interface HookOutputCommon {
-    continue?: boolean;
-    suppressOutput?: boolean;
-    stopReason?: string;
-    decision?: Decision;
-    reason?: string;
-    systemMessage?: string;
-    permissionDecision?: PermissionDecision;
-}
-/** PreToolUse: also accepts a hookSpecificOutput with PreToolUse fields. */
-export interface PreToolUseHookOutput extends HookOutputCommon {
-    hookSpecificOutput?: {
-        hookEventName: 'PreToolUse';
-        permissionDecision?: PermissionDecision;
-        permissionDecisionReason?: string;
-        updatedInput?: Record<string, unknown>;
-    };
-}
-/** PostToolUse: optional additionalContext to inject into the next turn. */
-export interface PostToolUseHookOutput extends HookOutputCommon {
-    hookSpecificOutput?: {
-        hookEventName: 'PostToolUse';
-        additionalContext?: string;
-    };
-}
-/** UserPromptSubmit: additionalContext REQUIRED if hookSpecificOutput is set. */
-export interface UserPromptSubmitHookOutput extends HookOutputCommon {
-    hookSpecificOutput?: {
-        hookEventName: 'UserPromptSubmit';
-        additionalContext: string;
-    };
-}
-/** Stop: no hookSpecificOutput. Only top-level fields are valid. */
-export type StopHookOutput = HookOutputCommon;
-/** SessionStart / SessionEnd / etc: top-level only (no hookSpecificOutput). */
-export type SessionStartHookOutput = HookOutputCommon;
-export type AnyHookOutput = PreToolUseHookOutput | PostToolUseHookOutput | UserPromptSubmitHookOutput | StopHookOutput | SessionStartHookOutput;
-export interface PreToolUsePayload {
-    tool_name?: string;
-    tool_input?: Record<string, unknown>;
-    session_id?: string;
-    transcript_path?: string;
-}
-export interface PostToolUsePayload {
-    tool_name?: string;
-    tool_input?: Record<string, unknown>;
-    tool_response?: Record<string, unknown>;
-    response?: Record<string, unknown>;
-    session_id?: string;
-    transcript_path?: string;
-}
-export interface UserPromptSubmitPayload {
-    prompt?: string;
-    user_message?: string;
-    message?: string;
-    session_id?: string;
-}
-export interface StopPayload {
-    session_id?: string;
-    transcript_path?: string;
-}
-export interface SessionStartPayload {
-    session_id?: string;
-}
-export interface ControllerEdit {
-    path: string;
-    editedTs: string;
-}
-export interface CoverageSnapshot {
-    uncoveredPaths?: number;
-    endpointsNotInSpec?: number;
-    staleBaselines?: number;
-    surfacedTs?: string | null;
-    previous?: CoverageSnapshot | null;
-    [extra: string]: unknown;
-}
-export interface LastAutoWorkbookMutation {
-    /** Bare tool name, e.g. "add_decision" / "update_task" (no mcp__ prefix). */
-    tool: string;
-    entityId: string | null;
-    createdInTurnId: number;
-    createdTs: string;
-    /** Only set for update_task — the status to restore on undo. */
-    priorStatus: string | null;
-}
-export interface CompanionMetrics {
-    autoDecisionLogs: number;
-    autoIssueLogs: number;
-    autoAssumptionLogs: number;
-    autoTaskStatusLogs: number;
-    undoCount: number;
-    verifyAutoRuns: number;
-    verifyAutoFailures: number;
-    qualityGateFailures: number;
-    contextGateFailures: number;
-    lockContention: number;
-    forceApprovals: number;
-}
-export interface CompanionState {
-    schemaVersion: number;
-    currentSessionId: string | null;
-    authoringMode: boolean;
-    authoringDocId: string | null;
-    authoringDocType: 'PRD' | 'TRD' | null;
-    authoringTranscriptPath: string | null;
-    authoringStartedTs: string | null;
-    pulseCount: number;
-    lastEditTs: string | null;
-    needsSpecPublish: boolean;
-    controllerEditsSinceLastPublish: ControllerEdit[];
-    coverageSnapshot: CoverageSnapshot | null;
-    coverageSnapshotTs: string | null;
-    coverageFetchPending: boolean;
-    lastVerifyCompletionTs: string | null;
-    recentDecisionHashes: string[];
-    recentIssueHashes: string[];
-    recentAssumptionHashes: string[];
-    lastAutoWorkbookMutation: LastAutoWorkbookMutation | null;
-    sessionAutoLogCount: number;
-    turnAutoLogCount: number;
-    currentTurnId: number;
-    suppressWorkbookUpdatesUntil: string | null;
-    pendingWorkbookSweep: boolean;
-    pendingWorkbookSweepReason: string | null;
-    lastSeenVerifyCompletionTs: string | null;
-    commandBus: CommandBusState;
-    metrics: CompanionMetrics;
-}
-/**
- * Patch shape for state.patch() — partial state + convenience "push" keys
- * that append to the corresponding ring buffer instead of replacing it.
- * `metrics` overrides the full-CompanionState definition to be partial.
- */
-export type StatePatch = Partial<Omit<CompanionState, 'metrics'>> & {
-    metrics?: Partial<CompanionMetrics>;
-    pushDecisionHash?: string;
-    pushIssueHash?: string;
-    pushAssumptionHash?: string;
-    pushControllerEdit?: ControllerEdit;
-};
-export interface PostEditPulseConfig {
-    enabled?: boolean;
-    threshold?: number;
-}
-export interface AutoVerifyConfig {
-    preTaskDone?: boolean;
-    prePush?: boolean;
-    postEditPulse?: PostEditPulseConfig;
-    autoPublishSpecOnControllerChange?: boolean;
-    controllerPaths?: string[];
-    verifyTimeoutSeconds?: number;
-    publishSpecTimeoutSeconds?: number;
-}
-export interface ThresholdOverrides {
-    decision?: number | null;
-    issue?: number | null;
-    assumption?: number | null;
-    taskStatus?: number | null;
-}
-export type PresetName = 'conservative' | 'balanced' | 'aggressive';
-export interface AutoWorkbookUpdatesConfig {
-    enabled?: boolean;
-    preset?: PresetName;
-    maxAutoLogsPerTurn?: number;
-    maxAutoLogsPerSession?: number;
-    undoWindow?: 'next-turn' | string;
-    thresholds?: ThresholdOverrides;
-    trivialTurnCharCutoff?: number;
-    hashRingBufferSize?: number;
-}
-export interface CoverageNudgesConfig {
-    enabled?: boolean;
-    staleBaselineDays?: number;
-    fetchMode?: 'async' | 'sync' | 'off';
-}
-export interface AuthoringConfig {
-    defaultDepth?: 'adaptive' | 'shallow' | 'deep';
-    existingWorkScan?: boolean;
-    qualityGate?: {
-        enabled?: boolean;
-    };
-    minViableContextGate?: {
-        enabled?: boolean;
-    };
-}
-export type CommandBusHook = 'sessionStart' | 'userPromptSubmit' | 'stop' | 'postToolUse';
-export type CommandBusReactionMode = 'HALT_AND_REPLAN' | 'ACKNOWLEDGE_AND_CONTINUE' | 'SILENT_LOG';
-export interface CommandBusConfig {
-    enabled?: boolean;
-    pollHooks?: CommandBusHook[];
-    minPollIntervalSeconds?: number;
-    reactionMode?: CommandBusReactionMode;
-    /**
-     * After this many consecutive poll failures the effective poll interval grows
-     * exponentially (backoff) so an unreachable inbox endpoint stops being polled
-     * on every hook fire. Defaults to 3.
-     */
-    circuitBreakerThreshold?: number;
-    /** Upper bound (seconds) on the backed-off poll interval. Defaults to 1800 (30m). */
-    maxBackoffSeconds?: number;
-}
-export interface CommandBusState {
-    cursor: string | null;
-    /** Timestamp of the last SUCCESSFUL poll (server clock). Used as the dedup/cursor anchor. */
-    lastPollTs: string | null;
-    /**
-     * Timestamp of the last poll ATTEMPT (success or failure, client clock). The
-     * min-interval / backoff floor is measured from here so repeated failures are
-     * throttled even before a first success exists.
-     */
-    lastAttemptTs?: string | null;
-    consecutiveFailures: number;
-    recentEventIds: string[];
-}
-export interface InboxEvent {
-    eventId: string;
-    featureId: string;
-    eventType: string;
-    sourceType: string;
-    sourceId: string | null;
-    urgency: 'BLOCKING' | 'INFORMATIONAL';
-    payload: Record<string, unknown>;
-    createdTs: string;
-    ttlAt: string;
-    issuerType: string;
-    issuerId: string | null;
-}
-export interface CompanionConfig {
-    companion?: {
-        autoVerify?: AutoVerifyConfig;
-        autoWorkbookUpdates?: AutoWorkbookUpdatesConfig;
-        coverageNudges?: CoverageNudgesConfig;
-        authoring?: AuthoringConfig;
-        commandBus?: CommandBusConfig;
-        safeMode?: boolean;
-    };
-}
-export interface Thresholds {
-    decision: number;
-    issue: number;
-    assumption: number;
-    taskStatus: number;
-}
-export interface ActiveFeature {
-    featureId: string | null;
-    featureName: string | null;
-}
-export interface SweepDirectiveOpts {
-    thresholds: Thresholds;
-    perTurnSlotsLeft: number;
-    perSessionSlotsLeft: number;
-    recentHashes: string[];
-    activeFeatureId: string | null;
-    activeFeatureName: string | null;
-}
-export interface ReversalDirective {
-    tool: 'update_decision' | 'update_issue' | 'update_task';
-    args: Record<string, unknown>;
-    humanLine: string;
-}
-export type HookEvent = 'session-start' | 'user-prompt-submit' | 'pre-tool-use' | 'post-tool-use' | 'stop' | 'state' | 'authoring-state';
-export interface RouterInvocation {
-    event: HookEvent | null;
-    route: string | null;
-    payload: unknown;
-    flags: Record<string, string | boolean>;
-}
-export interface QualityGateBlockingIssue {
-    section: string;
-    issue: string;
-    required_fix: string;
-}
-export interface QualityGateResult {
-    passed: boolean;
-    blockingIssues: QualityGateBlockingIssue[];
-}
-export {};

package/dist/hooks/types.js

@@ -1,14 +0,0 @@
-/**
- * types.ts — shared type definitions for Companion V2 hooks.
- *
- * Hook output types match Claude Code's documented schema (captured from
- * the schema error message hit in the V2.0 dogfood — Anthropic does not
- * publish official TS types as of 2026-05). Hook input payload types are
- * partials because Claude Code's payload shape varies per event and we
- * only consume the fields we use.
- *
- * Companion state and config match the on-disk JSON shape in
- * `.dezycro/companion-state.json` and `.dezycro/config.json`.
- */
-'use strict';
-Object.defineProperty(exports, "__esModule", { value: true });

package/install.js

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-
-const HOME = os.homedir();
-const commandsDir = path.join(HOME, ".claude", "commands", "dezycro");
-const skillsDir = path.join(__dirname, "skills");
-const settingsPath = path.join(HOME, ".claude", "settings.json");
-const hooksJsonPath = path.join(__dirname, "hooks", "hooks.json");
-const runnerPath = path.join(__dirname, "hooks", "companion-runner");
-
-fs.mkdirSync(commandsDir, { recursive: true });
-
-const skills = fs
-  .readdirSync(skillsDir, { withFileTypes: true })
-  .filter((d) => d.isDirectory() && fs.existsSync(path.join(skillsDir, d.name, "SKILL.md")))
-  .map((d) => d.name);
-
-for (const name of skills) {
-  const src = path.join(skillsDir, name, "SKILL.md");
-  const dst = path.join(commandsDir, `${name}.md`);
-  fs.copyFileSync(src, dst);
-}
-
-let hooksInstalled = false;
-let hooksAlreadyPresent = false;
-try {
-  const hooksConfig = JSON.parse(fs.readFileSync(hooksJsonPath, "utf8"));
-  const incoming = inlinePluginRoot(hooksConfig.hooks || {}, __dirname);
-
-  let existing = { hooks: {} };
-  if (fs.existsSync(settingsPath)) {
-    try { existing = JSON.parse(fs.readFileSync(settingsPath, "utf8")); }
-    catch { existing = { hooks: {} }; }
-  }
-  if (!existing.hooks) existing.hooks = {};
-
-  const before = JSON.stringify(existing.hooks);
-  for (const event of Object.keys(incoming)) {
-    const existingEntries = Array.isArray(existing.hooks[event]) ? existing.hooks[event] : [];
-    const filtered = existingEntries.filter((e) => !isDezycroEntry(e));
-    existing.hooks[event] = [...filtered, ...incoming[event]];
-  }
-  const after = JSON.stringify(existing.hooks);
-
-  if (before === after) {
-    hooksAlreadyPresent = true;
-  } else {
-    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-    fs.writeFileSync(settingsPath, JSON.stringify(existing, null, 2) + "\n");
-    hooksInstalled = true;
-  }
-
-  try { fs.chmodSync(runnerPath, 0o755); } catch {}
-} catch (err) {
-  console.log(`\n  ⚠ Could not install V2 hooks automatically: ${err.message}`);
-  console.log(`     Hooks config: ${hooksJsonPath}`);
-  console.log(`     Merge it into ${settingsPath} manually, or install as a Claude Code plugin.`);
-}
-
-console.log(`\n  ✓ Dezycro commands installed (${skills.length}) to ~/.claude/commands/dezycro/`);
-console.log(`     ${skills.map((s) => `/dezycro:${s}`).join(", ")}`);
-if (hooksInstalled) {
-  console.log(`  ✓ Companion V2 hooks merged into ~/.claude/settings.json`);
-} else if (hooksAlreadyPresent) {
-  console.log(`  ✓ Companion V2 hooks already present in ~/.claude/settings.json`);
-}
-console.log(`\n  Next: npx dezycro-setup`);
-console.log(`  Then: /dezycro:import-features\n`);
-
-function inlinePluginRoot(hooks, root) {
-  return JSON.parse(JSON.stringify(hooks, (k, v) => {
-    if (typeof v === "string") return v.replace(/"?\$\{CLAUDE_PLUGIN_ROOT\}"?/g, root);
-    return v;
-  }));
-}
-
-function isDezycroEntry(entry) {
-  if (!entry || typeof entry !== "object") return false;
-  const hooks = Array.isArray(entry.hooks) ? entry.hooks : [];
-  return hooks.some((h) => h && typeof h.command === "string" && h.command.includes("/hooks/companion-runner"));
-}

package/setup.js

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-
-const { execSync } = require("child_process");
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const readline = require("readline");
-
-const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-console.log(`\n  Dezycro Setup`);
-console.log(`  Get your API key from Dezycro → Settings → API Keys\n`);
-
-rl.question("  API key (dzy_...): ", (apiKey) => {
-  apiKey = (apiKey || "").trim();
-
-  if (!apiKey || !apiKey.startsWith("dzy_")) {
-    console.log(`\n  Invalid key. Must start with dzy_\n`);
-    rl.close();
-    process.exit(1);
-  }
-
-  const mcpUrl = "https://mcp.dezycro.ai";
-
-  // 1. Configure Claude Code MCP server.
-  try {
-    execSync(
-      `claude mcp add --transport http dezycro "${mcpUrl}/mcp" --header "Authorization: Bearer ${apiKey}"`,
-      { stdio: "inherit" }
-    );
-    console.log(`\n  ✓ Dezycro MCP configured`);
-  } catch (err) {
-    console.error(`\n  Failed to configure MCP. Run manually:`);
-    console.error(`  claude mcp add --transport http dezycro "${mcpUrl}/mcp" --header "Authorization: Bearer ${apiKey}"\n`);
-  }
-
-  // 2. Save the user-global Companion token so companion-runner can poll the
-  //    Agent Command Bus without per-repo config. Project-local
-  //    .dezycro/companion-token.local.json still overrides this.
-  try {
-    const globalDir = path.join(os.homedir(), ".dezycro");
-    const globalTokenPath = path.join(globalDir, "token.json");
-    fs.mkdirSync(globalDir, { recursive: true, mode: 0o700 });
-    fs.writeFileSync(globalTokenPath, JSON.stringify({ token: apiKey }, null, 2), { mode: 0o600 });
-    console.log(`  ✓ Companion token saved to ${globalTokenPath}`);
-  } catch (err) {
-    console.error(`  Failed to save companion token: ${err.message}`);
-    console.error(`  Drop it manually at ~/.dezycro/token.json: {"token": "${apiKey}"}\n`);
-  }
-
-  console.log(`\n  You're all set! In Claude Code run: /dezycro:import-features\n`);
-  rl.close();
-});