@ironbee-ai/cli 0.6.2 → 0.7.0

package/dist/analytics/classifier.js

@@ -0,0 +1,380 @@
+"use strict";
+/**
+ * IronBee CLI — Per-Turn Classifier
+ *
+ * Adapted from codeburn's `src/classifier.ts` — assigns each agent turn a
+ * `TurnCategory` label using:
+ *   1. **Tool patterns** — what tools were used (Edit/Read/Bash/Task/...)
+ *   2. **User message keywords** — regex match on the human-user prompt text
+ *   3. **Bash command keywords** — regex match on raw Bash command bodies
+ *
+ * The user message text and Bash command text are read locally for regex
+ * matching but **never emitted** on the wire — only `TurnCategory` labels
+ * and counter aggregates leave this module. Same privacy contract as the
+ * existing `extractBashBinary` path: content INPUT, structural label OUTPUT.
+ *
+ * Pattern coverage extends codeburn's runtime list to support modern JS/TS
+ * (vite/turbopack/swc/bun), Python (poetry/pdm/hatch/uv), JVM (gradle/sbt),
+ * .NET, Swift, Elixir, Erlang, Mobile (flutter/expo/eas), Cloud deploy
+ * (terraform/pulumi/cdk/k8s/helm), and 30+ test frameworks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIT_PATTERNS = exports.INSTALL_PATTERNS = exports.BUILD_PATTERNS = exports.TEST_PATTERNS = exports.URL_PATTERN = exports.SCRIPT_PATTERNS = exports.FILE_PATTERNS = exports.RESEARCH_KEYWORDS = exports.BRAINSTORM_KEYWORDS = exports.REFACTOR_KEYWORDS = exports.FEATURE_KEYWORDS = exports.DEBUG_KEYWORDS = void 0;
+exports.extractUserMsgKeywords = extractUserMsgKeywords;
+exports.applyToolBucketFlags = applyToolBucketFlags;
+exports.emptyToolBucketFlags = emptyToolBucketFlags;
+exports.emptyBashCmdFlags = emptyBashCmdFlags;
+exports.applyBashCmdFlags = applyBashCmdFlags;
+exports.classifyTurn = classifyTurn;
+// ─────────────────────────────────────────────────────────────────────────
+// Keyword regexes — applied to USER MESSAGE TEXT
+// ─────────────────────────────────────────────────────────────────────────
+exports.DEBUG_KEYWORDS = /\b(fix|bug|error|broken|failing|crash|issue|debug|traceback|exception|stack\s*trace|not\s+working|wrong|unexpected|status\s+code|404|500|401|403|segfault|panic|null\s*pointer|stacktrace|fatal|abort|crashed|fails?)\b/i;
+exports.FEATURE_KEYWORDS = /\b(add|create|implement|new|build|feature|introduce|set\s*up|scaffold|generate|make\s+(?:a|me|the|an|some)|write\s+(?:a|me|the|an|some)|develop|design)\b/i;
+exports.REFACTOR_KEYWORDS = /\b(refactor|clean\s*up|cleanup|rename|reorganize|simplify|extract|restructure|move|migrate|split|consolidate|inline|abstract|generalize|deduplicate)\b/i;
+exports.BRAINSTORM_KEYWORDS = /\b(brainstorm|idea|what\s+if|explore|think\s+about|approach|strategy|design|consider|how\s+should|what\s+would|opinion|suggest|recommend|tradeoff|alternative)\b/i;
+exports.RESEARCH_KEYWORDS = /\b(research|investigate|look\s+into|find\s+out|check|search|analyze|review|understand|explain|how\s+does|what\s+is|show\s+me|list|compare|describe|summarize)\b/i;
+exports.FILE_PATTERNS = /\.(py|js|ts|tsx|jsx|mjs|cjs|json|yaml|yml|toml|sql|sh|bash|zsh|fish|go|rs|java|rb|php|css|html|md|mdx|csv|xml|kt|kts|swift|dart|c|cpp|cc|h|hpp|cs|fs|fsx|ml|mli|hs|elm|ex|exs|erl|hrl|clj|cljs|nim|jl|lua|r|R|scala|sbt|vb|tf|hcl|graphql|gql|proto|svelte|vue|astro|sass|scss|less|stylus|env|gitignore|dockerfile|cfg|ini|properties|gradle|gemspec)\b/i;
+exports.SCRIPT_PATTERNS = /\b(run\s+\S+\.\w+|execute|scrip?t|curl|wget|api\s+\S+|endpoint|request\s+url|fetch\s+\S+|query|database|db\s+\S+|migration|migrate)\b/i;
+exports.URL_PATTERN = /https?:\/\/\S+/i;
+// ─────────────────────────────────────────────────────────────────────────
+// Command regexes — applied to USER MESSAGE TEXT and BASH COMMAND TEXT
+// ─────────────────────────────────────────────────────────────────────────
+/** Test runners across mainstream languages + CI coverage tooling. */
+exports.TEST_PATTERNS = new RegExp("\\b(" + [
+    // Action keywords (very broad — last-resort match)
+    "test", "spec", "coverage",
+    // JS/TS test frameworks + runners
+    "jest", "vitest", "mocha", "cypress", "playwright", "karma", "jasmine", "ava",
+    "tape", "wtr",
+    "npm\\s+test", "yarn\\s+test", "pnpm\\s+test", "bun\\s+test",
+    "npx\\s+(?:jest|vitest|mocha|cypress|playwright|jasmine|ava)",
+    // Python
+    "pytest", "nosetests?", "tox", "nox", "behave", "robot", "hypothesis",
+    "python3?\\s+-m\\s+(?:pytest|unittest|nose)",
+    "hatch\\s+test",
+    // Ruby
+    "rspec", "minitest", "cucumber", "rake\\s+test", "rake\\s+spec",
+    "bundle\\s+exec\\s+(?:rspec|cucumber|test)",
+    // Go
+    "go\\s+test", "gotestsum", "ginkgo",
+    // Rust
+    "cargo\\s+(?:test|nextest)",
+    // JVM (Java/Kotlin/Scala)
+    "mvn\\s+test", "gradle\\s+test", "gradlew\\s+test", "sbt\\s+test",
+    "junit", "kotest", "spek",
+    // PHP
+    "phpunit", "pest", "composer\\s+test",
+    // .NET
+    "dotnet\\s+test", "nunit", "xunit", "mstest",
+    // Swift / Apple
+    "swift\\s+test", "xcodebuild\\s+test",
+    // Elixir / Erlang
+    "mix\\s+test", "rebar3\\s+(?:eunit|ct|proper)",
+    // Native / Generic build-system test targets
+    "make\\s+(?:test|check)", "meson\\s+test", "ctest", "cmake\\s+--build.*--target\\s+test",
+    // CI / Coverage tooling
+    "codecov", "coveralls", "nyc", "c8", "jacoco",
+].join("|") + ")\\b", "i");
+/** Build, package, and deploy commands. */
+exports.BUILD_PATTERNS = new RegExp("\\b(" + [
+    // JS/TS bundlers + frameworks
+    "webpack", "rollup", "esbuild", "parcel", "swc", "tsup", "turbopack", "browserify", "rspack",
+    "next\\s+build", "nuxt\\s+build", "astro\\s+build", "gatsby\\s+build", "remix\\s+build",
+    "vite\\s+build",
+    // npm/yarn/pnpm/bun scripts
+    "npm\\s+run\\s+(?:build|dev|start|publish)", "npm\\s+(?:start|publish)",
+    "yarn\\s+(?:build|dev|start|publish)",
+    "pnpm\\s+(?:build|dev|start|publish)",
+    "bun\\s+run\\s+(?:build|dev|start)", "bun\\s+build",
+    // Python
+    "python3?\\s+setup\\.py", "setup\\.py\\s+(?:install|build|sdist|bdist)",
+    "poetry\\s+(?:build|publish)", "pdm\\s+build", "hatch\\s+build", "flit\\s+build",
+    "python3?\\s+-m\\s+build", "twine\\s+(?:upload|check)",
+    // Ruby
+    "rake\\s+build", "gem\\s+build", "gem\\s+push",
+    // Go
+    "go\\s+(?:build|run|install)",
+    // Rust
+    "cargo\\s+(?:build|run|publish|install)",
+    // JVM
+    "mvn\\s+(?:install|package|deploy|compile)",
+    "gradle\\s+(?:build|assemble|publish)", "gradlew\\s+(?:build|assemble|assembleDebug|assembleRelease)",
+    "sbt\\s+(?:compile|assembly|publish)",
+    // PHP
+    "composer\\s+(?:install|update|require|run)", "php\\s+artisan",
+    // .NET
+    "dotnet\\s+(?:build|run|publish|pack)",
+    // C/C++ / native
+    "make", "cmake", "ninja", "bazel\\s+build", "meson\\s+(?:setup|compile)",
+    // Containers / orchestration
+    "docker\\s+(?:build|push|compose|run|pull)", "docker-compose",
+    "podman\\s+(?:build|push|run)",
+    "kubectl\\s+(?:apply|delete|rollout|create)",
+    "helm\\s+(?:install|upgrade|uninstall)",
+    "skaffold", "tilt", "argocd", "flux",
+    // Cloud deploy / serverless / IaC
+    "vercel", "netlify", "fly\\s+deploy", "fly\\.io",
+    "gcloud\\s+(?:deploy|app|run|builds)",
+    "aws\\s+(?:s3|lambda|cloudformation|amplify|deploy|elasticbeanstalk)",
+    "az\\s+(?:webapp|deploy|functionapp)",
+    "terraform\\s+(?:apply|plan|destroy|init)",
+    "pulumi\\s+(?:up|destroy|preview)",
+    "cdk\\s+(?:deploy|destroy|synth)",
+    "ansible-playbook", "chef-client", "salt",
+    "serverless\\s+deploy", "sst\\s+deploy",
+    // Process managers
+    "pm2", "systemctl", "supervisorctl", "launchctl",
+    // Mobile
+    "flutter\\s+(?:build|run)", "expo\\s+(?:build|publish)", "eas\\s+build",
+    "react-native\\s+run", "pod\\s+install", "xcodebuild", "fastlane",
+    // Elixir / Erlang
+    "mix\\s+(?:compile|release|deps\\.get)", "rebar3\\s+(?:compile|release)",
+    // Misc bare keyword
+    "deploy",
+].join("|") + ")\\b", "i");
+/** Package install commands across language + system package managers. */
+exports.INSTALL_PATTERNS = new RegExp("\\b(" + [
+    // JS/TS
+    "npm\\s+(?:install|i|ci|add)",
+    "yarn\\s+(?:add|install)",
+    "pnpm\\s+(?:install|i|ci|add)",
+    "bun\\s+(?:install|i|add)",
+    // Python
+    "pip3?\\s+install", "pipx\\s+install", "pipenv\\s+install",
+    "poetry\\s+(?:add|install)", "pdm\\s+(?:add|install)",
+    "conda\\s+install", "mamba\\s+install",
+    "uv\\s+(?:pip\\s+install|add|sync)",
+    // Ruby
+    "gem\\s+install", "bundle\\s+(?:install|add|update)",
+    // Go
+    "go\\s+(?:get|install|mod\\s+download)",
+    // Rust
+    "cargo\\s+(?:add|install)",
+    // JVM
+    "mvn\\s+install", "gradle\\s+install",
+    // PHP
+    "composer\\s+(?:install|require|update|global)",
+    // .NET
+    "dotnet\\s+(?:add\\s+package|restore)", "nuget\\s+(?:install|restore)",
+    // System / OS package managers
+    "brew\\s+(?:install|reinstall|upgrade|tap)",
+    "apt(?:-get)?\\s+install", "dpkg\\s+-i",
+    "yum\\s+install", "dnf\\s+install",
+    "pacman\\s+-S[yu]*",
+    "zypper\\s+install", "pkg\\s+install", "apk\\s+add",
+    "port\\s+install",
+    "choco\\s+install", "scoop\\s+install", "winget\\s+install",
+    // Containers
+    "docker\\s+pull",
+].join("|") + ")\\b", "i");
+/** Git operations. */
+exports.GIT_PATTERNS = /\bgit\s+(push|pull|commit|merge|rebase|checkout|branch|stash|log|diff|status|add|reset|cherry-pick|tag|fetch|clone|switch|restore|worktree|submodule|remote|init|blame|reflog|revert|bisect)\b/i;
+// ─────────────────────────────────────────────────────────────────────────
+// Tool name buckets — used by classifier predicates
+// ─────────────────────────────────────────────────────────────────────────
+const EDIT_TOOLS = new Set([
+    "Edit", "Write", "MultiEdit", "NotebookEdit", "FileEditTool", "FileWriteTool",
+    "StrReplace", "Delete", "edit", "edit_file", "create_file", "delete_file",
+]);
+const READ_TOOLS = new Set([
+    "Read", "Grep", "Glob", "FileReadTool", "GrepTool", "GlobTool",
+    "read_file", "grep", "glob", "list_dir",
+]);
+const BASH_TOOLS = new Set([
+    "Bash", "BashOutput", "KillShell", "BashTool", "PowerShellTool", "Shell", "shell",
+]);
+const TASK_TOOLS = new Set([
+    "Task", "Agent", "AgentSpawn", "TodoWrite",
+]);
+const SEARCH_TOOLS = new Set([
+    "WebSearch", "WebFetch", "ToolSearch",
+]);
+const PLAN_TOOLS = new Set([
+    "TodoWrite", "ExitPlanMode", "Plan",
+]);
+/** Run all user-msg regexes on the prompt text — privacy-safe (only flags returned). */
+function extractUserMsgKeywords(text) {
+    if (text.length === 0) {
+        return {
+            debug: false, feature: false, refactor: false, brainstorm: false,
+            research: false, file_pattern: false, script_pattern: false, url: false,
+        };
+    }
+    return {
+        debug: exports.DEBUG_KEYWORDS.test(text),
+        feature: exports.FEATURE_KEYWORDS.test(text),
+        refactor: exports.REFACTOR_KEYWORDS.test(text),
+        brainstorm: exports.BRAINSTORM_KEYWORDS.test(text),
+        research: exports.RESEARCH_KEYWORDS.test(text),
+        file_pattern: exports.FILE_PATTERNS.test(text),
+        script_pattern: exports.SCRIPT_PATTERNS.test(text),
+        url: exports.URL_PATTERN.test(text),
+    };
+}
+/** Update tool-bucket flags to include a single tool name (idempotent OR). */
+function applyToolBucketFlags(flags, toolName) {
+    if (EDIT_TOOLS.has(toolName)) {
+        flags.edit = true;
+    }
+    if (READ_TOOLS.has(toolName)) {
+        flags.read = true;
+    }
+    if (BASH_TOOLS.has(toolName)) {
+        flags.bash = true;
+    }
+    if (TASK_TOOLS.has(toolName)) {
+        flags.task = true;
+    }
+    if (SEARCH_TOOLS.has(toolName)) {
+        flags.search = true;
+    }
+    if (PLAN_TOOLS.has(toolName)) {
+        flags.plan = true;
+    }
+    if (toolName.startsWith("mcp__")) {
+        flags.mcp = true;
+    }
+    if (toolName === "Skill" || toolName === "SlashCommand") {
+        flags.skill = true;
+    }
+}
+function emptyToolBucketFlags() {
+    return { edit: false, read: false, bash: false, task: false, search: false, mcp: false, skill: false, plan: false };
+}
+function emptyBashCmdFlags() {
+    return { test: false, build: false, install: false, git: false };
+}
+/** Scan a single Bash command body and OR its keyword flags into `flags`. */
+function applyBashCmdFlags(flags, command) {
+    if (command.length === 0) {
+        return;
+    }
+    if (exports.TEST_PATTERNS.test(command)) {
+        flags.test = true;
+    }
+    if (exports.BUILD_PATTERNS.test(command)) {
+        flags.build = true;
+    }
+    if (exports.INSTALL_PATTERNS.test(command)) {
+        flags.install = true;
+    }
+    if (exports.GIT_PATTERNS.test(command)) {
+        flags.git = true;
+    }
+}
+/**
+ * Classify a turn into one of 13 categories. Rules mirror codeburn's
+ * classifier with extended pattern coverage.
+ *
+ * Decision tree:
+ *   1. No tools used → keyword-only path (`brainstorming` / `exploration` /
+ *      `debugging` / `feature` / `coding` / `conversation`).
+ *   2. Plan tool used (TodoWrite/ExitPlanMode) → `planning`.
+ *   3. Task/Agent → `delegation`.
+ *   4. Bash without edits → bash-cmd-flags decide first
+ *      (test → `testing`, git → `git`, build/install → `build/deploy`),
+ *      else fall through to keyword refinement / coding.
+ *   5. Edit/Write present → `coding`, refined by keywords →
+ *      `debugging` / `refactoring` / `feature` / `coding`.
+ *   6. Bash + Read (no edit) → `exploration`, refined to `debugging` if
+ *      DEBUG keywords match.
+ *   7. Read-only → `exploration`.
+ *   8. Search / MCP → `exploration`.
+ *   9. Skill → `general`.
+ *
+ * Returns one of the 13 TurnCategory values; never null.
+ */
+function classifyTurn(s) {
+    const t = s.tool_buckets;
+    const k = s.user_msg_keywords;
+    const b = s.bash_cmd_flags;
+    const anyTool = t.edit || t.read || t.bash || t.task || t.search || t.mcp || t.skill || t.plan;
+    // Path 1: no tools — keyword-only conversation classification
+    if (!anyTool) {
+        if (k.brainstorm) {
+            return "brainstorming";
+        }
+        if (k.research) {
+            return "exploration";
+        }
+        if (k.debug) {
+            return "debugging";
+        }
+        if (k.feature) {
+            return "feature";
+        }
+        if (k.file_pattern || k.script_pattern) {
+            return "coding";
+        }
+        if (k.url) {
+            return "exploration";
+        }
+        return "conversation";
+    }
+    // Path 2-3: plan / delegation take precedence over data signals
+    if (t.plan && !t.edit) {
+        return "planning";
+    }
+    if (t.task) {
+        return "delegation";
+    }
+    // Path 4: Bash without edits — bash-cmd-flags + user-msg keyword
+    if (t.bash && !t.edit) {
+        if (b.test) {
+            return "testing";
+        }
+        if (b.git) {
+            return "git";
+        }
+        if (b.build || b.install) {
+            return "build/deploy";
+        }
+        // user-msg keyword fallback (codeburn parity)
+        if (k.debug) {
+            return "debugging";
+        }
+        if (k.research) {
+            return "exploration";
+        }
+    }
+    // Path 5: edit-driven coding, refined by keywords
+    if (t.edit) {
+        if (k.debug) {
+            return "debugging";
+        }
+        if (k.refactor) {
+            return "refactoring";
+        }
+        if (k.feature) {
+            return "feature";
+        }
+        return "coding";
+    }
+    // Path 6: bash + read = exploration (could be debugging)
+    if (t.bash && t.read) {
+        if (k.debug) {
+            return "debugging";
+        }
+        return "exploration";
+    }
+    // Path 7: bash-only fallback — codeburn calls this "coding" (running
+    // a script as part of dev work). Keep parity.
+    if (t.bash) {
+        return "coding";
+    }
+    // Path 8: search or MCP → exploration
+    if (t.search || t.mcp) {
+        return "exploration";
+    }
+    // Path 9: read-only → exploration
+    if (t.read) {
+        return "exploration";
+    }
+    // Path 10: skill → general
+    if (t.skill) {
+        return "general";
+    }
+    return "general";
+}
+//# sourceMappingURL=classifier.js.map

package/dist/analytics/classifier.js.map

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

package/dist/analytics/emit.d.ts

@@ -0,0 +1,67 @@
+/**
+ * IronBee CLI — Analytics Emit Orchestrator
+ *
+ * Per-trigger algorithm:
+ *
+ *   1. Load state (or initialState on miss)
+ *   2. Reset detection: schema_version, inode, size, first-KB hash
+ *   3. Tail-parse new transcript bytes (with truncate-during-read sanity)
+ *   4. Turn-safe boundary detection
+ *   5. Project delta + merge into accumulated
+ *   6. Substantive filter
+ *   7. Idempotency check (offset + final-flag)
+ *   8. EMIT-FIRST then atomic-rename state file
+ *
+ * Hook adapters call {@link emitAnalytics} after their existing primary
+ * work; failures here log and swallow — never affect the hook outcome.
+ *
+ * Submission goes DIRECTLY to the collector (`src/lib/collector.ts:sendToCollector`)
+ * — bypasses the queue intentionally. The queue's 4 KB per-line limit fits
+ * `tool_call` events but is too tight for full session aggregates. Direct
+ * HTTPS POST has no size limit; emit's own retry semantics (state isn't
+ * advanced on submit failure → next trigger retries) replace the queue's
+ * retry layer for this event type.
+ */
+import { TranscriptSource } from "./types";
+import { emptyAccumulated } from "./state";
+import { AnalyticsLog } from "./log";
+export type TriggerType = "Stop" | "SessionEnd";
+export interface EmitOptions {
+    projectDir: string;
+    sessionId: string;
+    triggerType: TriggerType;
+    /** Reason from the SessionEnd payload (Claude/Cursor pass it through). */
+    endReason?: string;
+    /**
+     * Override transcript source. Defaults to "claude-code" — Cursor
+     * coverage is gated on path resolution (open question §9). Hook
+     * adapters that detect Cursor should pass "cursor" or "missing".
+     */
+    transcriptSource?: TranscriptSource;
+    /**
+     * Optional per-session debug log. When provided, every step of the
+     * pipeline writes a line to `<analyticsDir>/analytics.log`. Hook
+     * adapters supply this via `runAnalyticsTrigger`; tests / direct
+     * callers can omit it (no-op).
+     */
+    log?: AnalyticsLog;
+}
+export interface EmitOutcome {
+    /** What happened: "emitted" | "skipped" | "no-transcript" | "error" */
+    status: "emitted" | "skipped" | "no-transcript" | "error";
+    /** Reason string for diagnostics. */
+    reason: string;
+    /** When emitted, the offset that was just covered. */
+    offset?: number;
+}
+/**
+ * Drive a full per-trigger projection and (maybe) emit. Fail-safe:
+ * any internal exception is caught + logged + swallowed; returns an
+ * outcome describing what happened.
+ */
+export declare function emitAnalytics(opts: EmitOptions): Promise<EmitOutcome>;
+/** Exposed for tests — never call from prod code. */
+export declare const __test: {
+    emptyAccumulated: typeof emptyAccumulated;
+};
+//# sourceMappingURL=emit.d.ts.map

package/dist/analytics/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/analytics/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAeH,gBAAgB,EACnB,MAAM,SAAS,CAAC;AAajB,OAAO,EAAE,gBAAgB,EAAuC,MAAM,SAAS,CAAC;AAKhF,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAMrC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAEhD,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,uEAAuE;IACvE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,GAAG,OAAO,CAAC;IAC1D,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAO3E;AA4/BD,qDAAqD;AACrD,eAAO,MAAM,MAAM,EAAE;IAAE,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;CAE/D,CAAC"}