@nomadamas/k-skill 0.9.1 → 0.10.0

package/skills/multi-asset-morning-briefing/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "multi-asset-morning-briefing",
+  "description": "글로벌 주식·금리·외환·원자재·변동성과 한국시장 전달 경로를 연결해 근거 링크가 있는 7개 섹션의 멀티에셋 모닝 브리핑을 작성한다. Use when the user asks 모닝 브리핑, Morning Call, 오버나이트 시황, 데일리 마켓 브리핑 또는 기존 브리핑 검수. Not for 실시간 호가, 국내 개별 종목 단독 조회(korean-stock-search), 투자 권유·매매 판단.",
+  "profiles": [
+    "lookup",
+    "browser"
+  ],
+  "frontmatter": "name: multi-asset-morning-briefing\ndescription: 글로벌 주식·금리·외환·원자재·변동성과 한국시장 전달 경로를 연결해 근거 링크가 있는 7개 섹션의 멀티에셋 모닝 브리핑을 작성한다. Use when the user asks 모닝 브리핑, Morning Call, 오버나이트 시황, 데일리 마켓 브리핑 또는 기존 브리핑 검수. Not for 실시간 호가, 국내 개별 종목 단독 조회(korean-stock-search), 투자 권유·매매 판단.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"
+}

package/src/analytics-policy.json

@@ -0,0 +1,18 @@
+{
+  "purpose": "usage_statistics_only",
+  "event": "cli_invocation",
+  "collected_properties": [
+    "command",
+    "skill_name",
+    "cli_version",
+    "runtime_mode",
+    "success",
+    "analytics_schema_version"
+  ],
+  "excluded_data": [
+    "command_arguments",
+    "command_input",
+    "file_contents"
+  ],
+  "opt_out_environment_variable": "KSKILL_ANALYTICS_DISABLED"
+}

package/src/analytics.js

@@ -0,0 +1,106 @@
+"use strict";
+
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { version: cliVersion } = require("../package.json");
+const policy = require("./analytics-policy.json");
+
+const DEFAULT_HOST = "https://us.i.posthog.com";
+const DEFAULT_PROJECT_API_KEY =
+  "phc_xlJYWKplsT2UNHng9eDULTGddlq0RoTuE8Dh64nrpmL";
+const ANALYTICS_SCHEMA_VERSION = 1;
+const DISABLED_VALUES = new Set(["1", "true", "yes", "on"]);
+
+function isDisabled(env) {
+  return DISABLED_VALUES.has(String(env.KSKILL_ANALYTICS_DISABLED || "").toLowerCase());
+}
+
+function analyticsIdPath(env) {
+  return (
+    env.KSKILL_ANALYTICS_ID_FILE ||
+    path.join(env.KSKILL_CONFIG_DIR || path.join(os.homedir(), ".config", "k-skill"), "analytics-id")
+  );
+}
+
+function readOrCreateAnalyticsId(env, randomUUID = crypto.randomUUID) {
+  if (env.KSKILL_ANALYTICS_ID) return env.KSKILL_ANALYTICS_ID;
+
+  const idPath = analyticsIdPath(env);
+  try {
+    const existing = fs.readFileSync(idPath, "utf8").trim();
+    if (existing) return existing;
+  } catch (error) {
+    if (error.code !== "ENOENT") return randomUUID();
+  }
+
+  const generated = randomUUID();
+  try {
+    fs.mkdirSync(path.dirname(idPath), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(idPath, `${generated}\n`, { encoding: "utf8", mode: 0o600 });
+  } catch {
+    // Analytics must never make the CLI command fail.
+  }
+  return generated;
+}
+
+function analyticsConfig(env = process.env) {
+  if (isDisabled(env)) return null;
+
+  return {
+    apiKey: env.POSTHOG_API_KEY || DEFAULT_PROJECT_API_KEY,
+    host: (env.POSTHOG_HOST || DEFAULT_HOST).replace(/\/+$/, ""),
+    distinctId: readOrCreateAnalyticsId(env),
+  };
+}
+
+function buildInvocationEvent({ command, skillName, runtimeMode, success }) {
+  return {
+    event: policy.event,
+    properties: {
+      command: command || null,
+      skill_name: skillName || null,
+      cli_version: cliVersion,
+      runtime_mode: runtimeMode,
+      success: Boolean(success),
+      analytics_schema_version: ANALYTICS_SCHEMA_VERSION,
+      $process_person_profile: false,
+      disable_geoip: true,
+    },
+  };
+}
+
+async function captureInvocation(details, env = process.env, fetchImpl = fetch) {
+  const config = analyticsConfig(env);
+  if (!config) return false;
+
+  const event = buildInvocationEvent(details);
+  const payload = JSON.stringify({
+    api_key: config.apiKey,
+    distinct_id: config.distinctId,
+    event: event.event,
+    properties: event.properties,
+  });
+
+  try {
+    const response = await fetchImpl(`${config.host}/i/v0/e/`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: payload,
+      signal: AbortSignal.timeout(1500),
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+
+module.exports = {
+  ANALYTICS_SCHEMA_VERSION,
+  DEFAULT_PROJECT_API_KEY,
+  analyticsConfig,
+  buildInvocationEvent,
+  captureInvocation,
+  readOrCreateAnalyticsId,
+};

package/src/metrics.js

@@ -0,0 +1,49 @@
+"use strict";
+
+function inWindow(timestamp, start, end) {
+  const value = new Date(timestamp).getTime();
+  return Number.isFinite(value) && value >= start && value < end;
+}
+
+function uniqueIds(events) {
+  return new Set(events.map((event) => event.distinct_id).filter(Boolean)).size;
+}
+
+function deriveUsageMetrics(events, end = Date.now()) {
+  const windows = {
+    daily: 24 * 60 * 60 * 1000,
+    weekly: 7 * 24 * 60 * 60 * 1000,
+    monthly: 30 * 24 * 60 * 60 * 1000,
+  };
+
+  const metrics = {};
+  for (const [name, duration] of Object.entries(windows)) {
+    const selected = events.filter((event) =>
+      inWindow(event.timestamp, end - duration, end),
+    );
+    const uniqueUsers = uniqueIds(selected);
+    metrics[name] = {
+      calls: selected.length,
+      uniqueUsers,
+      executionsPerUniqueUser: uniqueUsers ? selected.length / uniqueUsers : 0,
+    };
+  }
+
+  const recentIds = new Set(
+    events
+      .filter((event) => inWindow(event.timestamp, end - windows.weekly, end))
+      .map((event) => event.distinct_id)
+      .filter(Boolean),
+  );
+  const priorIds = new Set(
+    events
+      .filter((event) => inWindow(event.timestamp, end - 2 * windows.weekly, end - windows.weekly))
+      .map((event) => event.distinct_id)
+      .filter(Boolean),
+  );
+  metrics.recurrentUsers = [...recentIds].filter((id) => priorIds.has(id)).length;
+
+  return metrics;
+}
+
+module.exports = { deriveUsageMetrics };