@soddong/agentic-runtime 0.16.0

package/dist/claude-code-adapter.js

@@ -0,0 +1,177 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getProjectHookCommand } from "./hook-command.js";
+import { getRuntimeInfo } from "./runtime-info.js";
+const SOURCE = "claude-code";
+const USER_PROMPT_COMMAND = getProjectHookCommand(SOURCE, "UserPromptSubmit");
+const STOP_COMMAND = getProjectHookCommand(SOURCE, "Stop");
+function runClaude(args, cwd) {
+    const result = spawnSync("claude", [...args], {
+        cwd,
+        encoding: "utf8",
+        stdio: "pipe"
+    });
+    return result.status === 0;
+}
+function hasClaudeCli(cwd) {
+    return runClaude(["--version"], cwd);
+}
+function readSettings(settingsPath) {
+    if (!existsSync(settingsPath)) {
+        return {};
+    }
+    const parsed = JSON.parse(readFileSync(settingsPath, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`${settingsPath} must contain a JSON object`);
+    }
+    return parsed;
+}
+function hasCommand(settings, eventName, command) {
+    const groups = settings.hooks?.[eventName] ?? [];
+    return groups.some((group) => (group.hooks ?? []).some((hook) => hook.type === "command" && hook.command === command));
+}
+function addCommandHook(settings, eventName, command) {
+    if (hasCommand(settings, eventName, command)) {
+        return false;
+    }
+    settings.hooks = settings.hooks ?? {};
+    settings.hooks[eventName] = settings.hooks[eventName] ?? [];
+    settings.hooks[eventName].push({
+        matcher: "",
+        hooks: [
+            {
+                type: "command",
+                command
+            }
+        ]
+    });
+    return true;
+}
+function runtimeRuleMarkdown() {
+    return `# Agentic Runtime for Claude Code
+
+이 프로젝트는 \`agentic-runtime\`을 사용해 사용자 지시, Agent 실행 상태, 로그, 결과를 \`.agentic/platform.sqlite\`에 기록합니다.
+
+## Execution Recording Policy
+
+- Claude Code \`UserPromptSubmit\` hook은 사용자 prompt를 \`agentic-runtime\` execution DB에 기록합니다.
+- Claude Code \`Stop\` hook은 turn 종료를 기록합니다.
+- 이전 지시, 작업 이력, 최근 결과, 실패 이력, 작업 현황을 질문받으면 현재 대화 기억에만 의존하지 말고 execution DB를 먼저 조회합니다.
+
+## Execution Query Commands
+
+\`\`\`bash
+npx agentic execution latest --source claude-code --format json
+npx agentic execution list --range 7d --source claude-code --format json
+npx agentic execution summary --range today --source claude-code --format json
+\`\`\`
+
+조회 결과가 있으면 \`agentic_user_requests\`, \`agentic_execution_runs\`, \`agentic_execution_logs\`, \`agentic_execution_outputs\` 기록을 기준으로 답변합니다.
+
+## Agent Resource Context Policy
+
+- 사용자가 문서 작성, 산출물 작성, 검증, 가이드 기반 작업을 요청하면 설치된 Agent package의 resource context를 먼저 확인합니다.
+- 처음 사용하는 package는 한 번 등록합니다.
+
+\`\`\`bash
+npx agentic agent register agentic-domain-document
+\`\`\`
+
+- 요청별 context 확인 명령은 다음과 같습니다.
+
+\`\`\`bash
+npx agentic agent context "<사용자 지시문>"
+npx agentic agent context "<사용자 지시문>" --format json
+\`\`\`
+
+- 조회된 context가 있으면 해당 instruction, guide, example, validation rule을 우선 적용합니다.
+`;
+}
+function readmeMarkdown() {
+    const runtimeInfo = getRuntimeInfo();
+    return `# Agentic Runtime Claude Code Adapter
+
+runtime: \`${runtimeInfo.name}@${runtimeInfo.version}\`
+
+Claude Code adapter는 프로젝트의 \`.claude/settings.json\`에 다음 hook을 등록합니다.
+
+| Claude Code hook | Command |
+| --- | --- |
+| UserPromptSubmit | \`${USER_PROMPT_COMMAND}\` |
+| Stop | \`${STOP_COMMAND}\` |
+
+Command hook은 Claude Code가 전달하는 JSON input을 stdin으로 받아 \`agentic-runtime\` execution DB에 기록합니다.
+`;
+}
+export function installClaudeCodeAdapter(projectRoot = process.cwd(), options = {}) {
+    const filesWritten = [];
+    const messages = [];
+    const settingsPath = join(projectRoot, ".claude", "settings.json");
+    const rulePath = join(projectRoot, ".claude", "rules", "agentic-runtime.md");
+    const readmePath = join(projectRoot, "plugins", "agentic-runtime-claude-code", "README.md");
+    const claudeCliAvailable = hasClaudeCli(projectRoot);
+    mkdirSync(join(settingsPath, ".."), { recursive: true });
+    mkdirSync(join(rulePath, ".."), { recursive: true });
+    mkdirSync(join(readmePath, ".."), { recursive: true });
+    const settings = readSettings(settingsPath);
+    const changedUserPrompt = addCommandHook(settings, "UserPromptSubmit", USER_PROMPT_COMMAND);
+    const changedStop = addCommandHook(settings, "Stop", STOP_COMMAND);
+    if (changedUserPrompt || changedStop || !existsSync(settingsPath) || options.force === true) {
+        writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf8");
+        filesWritten.push(settingsPath);
+    }
+    if (!existsSync(rulePath) || options.force === true) {
+        writeFileSync(rulePath, runtimeRuleMarkdown(), "utf8");
+        filesWritten.push(rulePath);
+    }
+    if (!existsSync(readmePath) || options.force === true) {
+        writeFileSync(readmePath, readmeMarkdown(), "utf8");
+        filesWritten.push(readmePath);
+    }
+    if (!claudeCliAvailable) {
+        messages.push("Claude Code CLI was not found. Project settings and rules were still generated.");
+    }
+    messages.push("Claude Code hooks were configured in .claude/settings.json.");
+    return {
+        settingsPath,
+        rulePath,
+        filesWritten,
+        claudeCliAvailable,
+        hooksConfigured: hasCommand(settings, "UserPromptSubmit", USER_PROMPT_COMMAND) && hasCommand(settings, "Stop", STOP_COMMAND),
+        messages
+    };
+}
+export function getClaudeCodeAdapterStatus(projectRoot = process.cwd()) {
+    const settingsPath = join(projectRoot, ".claude", "settings.json");
+    const rulePath = join(projectRoot, ".claude", "rules", "agentic-runtime.md");
+    const notes = [];
+    const claudeCliAvailable = hasClaudeCli(projectRoot);
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = readSettings(settingsPath);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            notes.push(`settings.json is invalid: ${message}`);
+        }
+    }
+    if (!claudeCliAvailable) {
+        notes.push("Claude Code CLI was not found.");
+    }
+    return {
+        settingsExists: existsSync(settingsPath),
+        ruleExists: existsSync(rulePath),
+        claudeCliAvailable,
+        userPromptHookConfigured: hasCommand(settings, "UserPromptSubmit", USER_PROMPT_COMMAND),
+        stopHookConfigured: hasCommand(settings, "Stop", STOP_COMMAND),
+        notes
+    };
+}
+export const claudeCodeAdapterCommands = {
+    source: SOURCE,
+    userPromptCommand: USER_PROMPT_COMMAND,
+    stopCommand: STOP_COMMAND
+};
+//# sourceMappingURL=claude-code-adapter.js.map

package/dist/claude-code-adapter.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runCli(argv?: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA82DA,wBAAsB,MAAM,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+L7F"}