archik 0.15.1 → 0.16.0

package/dist/trace.d.ts

@@ -0,0 +1,18 @@
+export type TraceStepInput = {
+    id?: string;
+    from: string;
+    to: string;
+    label: string;
+    in?: unknown;
+    out?: unknown;
+    status?: "ok" | "error";
+};
+export type TraceRecorder = {
+    step(s: TraceStepInput): TraceRecorder;
+    flush(): void;
+};
+export declare function trace(opts: {
+    useCase: string;
+    slice: string;
+    seqFile?: string;
+}): TraceRecorder;

package/dist/trace.js

@@ -0,0 +1,58 @@
+// src/trace/recorder.ts
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+function findProjectRoot(start) {
+  let dir = start;
+  for (let i = 0; i < 30; i++) {
+    if (existsSync(path.join(dir, ".archik"))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return start;
+}
+function trace(opts) {
+  const steps = [];
+  let flushed = false;
+  const onExit = () => recorder.flush();
+  const recorder = {
+    step(s) {
+      const data = s.in !== void 0 || s.out !== void 0 ? {
+        ...s.in !== void 0 ? { in: s.in } : {},
+        ...s.out !== void 0 ? { out: s.out } : {}
+      } : void 0;
+      steps.push({
+        ...s.id !== void 0 ? { id: s.id } : {},
+        from: s.from,
+        to: s.to,
+        label: s.label,
+        ...data !== void 0 ? { data } : {},
+        status: s.status ?? "ok"
+      });
+      return recorder;
+    },
+    flush() {
+      if (flushed) return;
+      flushed = true;
+      const root = findProjectRoot(process.cwd());
+      const dir = path.join(root, ".archik", "traces");
+      mkdirSync(dir, { recursive: true });
+      const doc = {
+        version: "1.0",
+        useCase: opts.useCase,
+        slice: opts.slice,
+        ...opts.seqFile !== void 0 ? { seqFile: opts.seqFile } : {},
+        recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        steps
+      };
+      const file = path.join(dir, `${opts.useCase}.${opts.slice}.archik.trace.json`);
+      writeFileSync(file, JSON.stringify(doc, null, 2) + "\n", "utf-8");
+      process.removeListener("exit", onExit);
+    }
+  };
+  process.on("exit", onExit);
+  return recorder;
+}
+export {
+  trace
+};