@akanjs/cli 2.4.0 → 2.4.1-rc.0

package/index-85msc0wg.js

@@ -0,0 +1,161 @@
+// @bun
+import {
+  AkanContextAnalyzer
+} from "./index-8rc0bm04.js";
+import {
+  createRepairReport,
+  generatedFilePathsForTarget,
+  renderRepairReport,
+  writeGeneratedSyncState,
+  writeWorkflowRunArtifact
+} from "./index-h6ca6qg0.js";
+import {
+  runner
+} from "./index-hdqztm58.js";
+
+// pkgs/@akanjs/cli/repair/repair.runner.ts
+var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;
+var defaultExecutor = (workspace) => async (command) => {
+  try {
+    const stdout = await workspace.spawn("bash", ["-lc", commandForShell(command.command)], {
+      cwd: workspace.workspaceRoot
+    });
+    return {
+      command: command.command,
+      reason: command.reason,
+      status: "passed",
+      exitCode: 0,
+      stdout
+    };
+  } catch (error) {
+    const commandError = error;
+    return {
+      command: command.command,
+      reason: command.reason,
+      status: "failed",
+      exitCode: commandError.code ?? 1,
+      stdout: commandError.stdout,
+      stderr: commandError.stderr ?? commandError.message
+    };
+  }
+};
+var targetMissing = (input) => ({
+  severity: "error",
+  code: "repair-input-missing",
+  input,
+  message: `Repair command requires "${input}".`
+});
+var repairAction = (kind, command, reason, safeToRun) => ({
+  kind,
+  command,
+  reason,
+  safeToRun
+});
+
+class RepairRunner extends runner("repair") {
+  async repair(kind, {
+    workspace,
+    app = null,
+    module = null,
+    target = null,
+    format = "markdown",
+    execute
+  }) {
+    const executor = execute ?? defaultExecutor(workspace);
+    const report = await this.createRepairReport(kind, { workspace, app, module, target, execute: executor });
+    const { artifact, runId } = await writeWorkflowRunArtifact(workspace, report);
+    const reportWithArtifact = artifact;
+    if (kind === "generated" && reportWithArtifact.status === "passed" && reportWithArtifact.target) {
+      await writeGeneratedSyncState(workspace, {
+        schemaVersion: 1,
+        target: reportWithArtifact.target,
+        status: "passed",
+        syncedAt: reportWithArtifact.syncedAt ?? new Date().toISOString(),
+        command: `akan sync ${reportWithArtifact.target}`,
+        runId,
+        generatedFiles: reportWithArtifact.generatedFiles ?? []
+      });
+    }
+    return renderRepairReport(reportWithArtifact, format);
+  }
+  async createRepairReport(kind, {
+    workspace,
+    app = null,
+    module = null,
+    target = null,
+    execute
+  }) {
+    if (kind === "generated") {
+      if (!app) {
+        return createRepairReport({ command: "repair generated", kind, diagnostics: [targetMissing("app")] });
+      }
+      const command = { command: `akan sync ${app}`, reason: "Refresh generated Akan files from source conventions." };
+      const result = await execute(command);
+      const [apps] = await workspace.getSyss();
+      const targetRoot = `${apps.includes(app) ? "apps" : "libs"}/${app}`;
+      return createRepairReport({
+        command: "repair generated",
+        kind,
+        target: app,
+        repairActions: [repairAction(kind, command.command, command.reason, true)],
+        nextActions: [
+          { command: `akan doctor --strict --format json`, reason: "Re-run doctor after generated files refresh." }
+        ],
+        commands: [result],
+        generatedFiles: generatedFilePathsForTarget(targetRoot),
+        ...result.status === "passed" ? { syncedAt: new Date().toISOString() } : {}
+      });
+    }
+    if (kind === "format" || kind === "imports") {
+      if (!target) {
+        return createRepairReport({ command: `repair ${kind}`, kind, diagnostics: [targetMissing("target")] });
+      }
+      const command = { command: `akan lint ${target}`, reason: "Run Biome lint/fix path for formatting and imports." };
+      return createRepairReport({
+        command: `repair ${kind}`,
+        kind,
+        target,
+        repairActions: [repairAction(kind, command.command, command.reason, true)],
+        nextActions: [{ command: `akan doctor --strict --format json`, reason: "Re-run doctor after lint repair." }],
+        commands: [await execute(command)]
+      });
+    }
+    if (!app || !module) {
+      return createRepairReport({
+        command: `repair ${kind}`,
+        kind,
+        target: app,
+        diagnostics: [!app ? targetMissing("app") : targetMissing("module")]
+      });
+    }
+    const doctor = await AkanContextAnalyzer.doctor(workspace, { strict: true });
+    const diagnostics = doctor.diagnostics.filter((diagnostic) => {
+      if (kind === "dictionary")
+        return diagnostic.code === "dictionary-label-missing" && diagnostic.path?.includes(module);
+      return (diagnostic.code === "module-shape-invalid" || diagnostic.code === "module-abstract-missing") && diagnostic.path?.includes(module);
+    });
+    const actionCommand = kind === "dictionary" ? `akan add-field --app ${app} --module ${module} --field <field> --type <type> --format json` : `akan create-module ${module} --app ${app} --format json`;
+    return createRepairReport({
+      command: `repair ${kind}`,
+      kind,
+      target: `${app}:${module}`,
+      diagnostics: diagnostics.length > 0 ? diagnostics : [
+        {
+          severity: "warning",
+          code: `repair-${kind}-no-automatic-change`,
+          message: `No safe automatic ${kind} repair was applied for ${app}:${module}.`
+        }
+      ],
+      repairActions: [
+        repairAction(kind, actionCommand, "Use an explicit primitive command for source-safe repair.", false)
+      ],
+      nextActions: [
+        { command: actionCommand, reason: "Run a source-aware primitive if this repair is needed." },
+        { command: "akan doctor --strict --format json", reason: "Re-run doctor after manual or primitive repair." }
+      ],
+      commands: []
+    });
+  }
+}
+
+export { RepairRunner };