@nomai/nomai 0.1.0

package/dist/dist-DSXfsMP5.mjs

@@ -0,0 +1,145 @@
+import { n as __require, t as __commonJSMin } from "./rolldown-runtime-C7HZzL1F.mjs";
+//#region node_modules/@vercel/detect-agent/dist/index.js
+var require_dist = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	var __defProp = Object.defineProperty;
+	var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+	var __getOwnPropNames = Object.getOwnPropertyNames;
+	var __hasOwnProp = Object.prototype.hasOwnProperty;
+	var __export = (target, all) => {
+		for (var name in all) __defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	};
+	var __copyProps = (to, from, except, desc) => {
+		if (from && typeof from === "object" || typeof from === "function") {
+			for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+				get: () => from[key],
+				enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+			});
+		}
+		return to;
+	};
+	var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+	var src_exports = {};
+	__export(src_exports, {
+		KNOWN_AGENTS: () => KNOWN_AGENTS,
+		determineAgent: () => determineAgent
+	});
+	module.exports = __toCommonJS(src_exports);
+	var import_promises = __require("node:fs/promises");
+	var import_node_fs = __require("node:fs");
+	const DEVIN_LOCAL_PATH = "/opt/.devin";
+	const CURSOR = "cursor";
+	const CURSOR_CLI = "cursor-cli";
+	const CLAUDE = "claude";
+	const COWORK = "cowork";
+	const DEVIN = "devin";
+	const REPLIT = "replit";
+	const GEMINI = "gemini";
+	const CODEX = "codex";
+	const ANTIGRAVITY = "antigravity";
+	const AUGMENT_CLI = "augment-cli";
+	const OPENCODE = "opencode";
+	const GITHUB_COPILOT = "github-copilot";
+	const GITHUB_COPILOT_CLI = "github-copilot-cli";
+	const V0 = "v0";
+	const KNOWN_AGENTS = {
+		CURSOR,
+		CURSOR_CLI,
+		CLAUDE,
+		COWORK,
+		DEVIN,
+		REPLIT,
+		GEMINI,
+		CODEX,
+		ANTIGRAVITY,
+		AUGMENT_CLI,
+		OPENCODE,
+		GITHUB_COPILOT,
+		V0
+	};
+	async function determineAgent() {
+		if (process.env.AI_AGENT) {
+			const name = process.env.AI_AGENT.trim();
+			if (name) {
+				if (name === GITHUB_COPILOT || name === GITHUB_COPILOT_CLI) return {
+					isAgent: true,
+					agent: { name: GITHUB_COPILOT }
+				};
+				if (name === V0) return {
+					isAgent: true,
+					agent: { name: V0 }
+				};
+				return {
+					isAgent: true,
+					agent: { name }
+				};
+			}
+		}
+		if (process.env.CURSOR_TRACE_ID) return {
+			isAgent: true,
+			agent: { name: CURSOR }
+		};
+		if (process.env.CURSOR_AGENT || process.env.CURSOR_EXTENSION_HOST_ROLE === "agent-exec") return {
+			isAgent: true,
+			agent: { name: CURSOR_CLI }
+		};
+		if (process.env.GEMINI_CLI) return {
+			isAgent: true,
+			agent: { name: GEMINI }
+		};
+		if (process.env.CODEX_SANDBOX || process.env.CODEX_CI || process.env.CODEX_THREAD_ID) return {
+			isAgent: true,
+			agent: { name: CODEX }
+		};
+		if (process.env.ANTIGRAVITY_AGENT) return {
+			isAgent: true,
+			agent: { name: ANTIGRAVITY }
+		};
+		if (process.env.AUGMENT_AGENT) return {
+			isAgent: true,
+			agent: { name: AUGMENT_CLI }
+		};
+		if (process.env.OPENCODE_CLIENT) return {
+			isAgent: true,
+			agent: { name: OPENCODE }
+		};
+		if (process.env.CLAUDECODE || process.env.CLAUDE_CODE) {
+			if (process.env.CLAUDE_CODE_IS_COWORK) return {
+				isAgent: true,
+				agent: { name: COWORK }
+			};
+			return {
+				isAgent: true,
+				agent: { name: CLAUDE }
+			};
+		}
+		if (process.env.REPL_ID) return {
+			isAgent: true,
+			agent: { name: REPLIT }
+		};
+		if (process.env.COPILOT_MODEL || process.env.COPILOT_ALLOW_ALL || process.env.COPILOT_GITHUB_TOKEN) return {
+			isAgent: true,
+			agent: { name: GITHUB_COPILOT }
+		};
+		try {
+			await (0, import_promises.access)(DEVIN_LOCAL_PATH, import_node_fs.constants.F_OK);
+			return {
+				isAgent: true,
+				agent: { name: DEVIN }
+			};
+		} catch (_error) {}
+		return {
+			isAgent: false,
+			agent: void 0
+		};
+	}
+	0 && (module.exports = {
+		KNOWN_AGENTS,
+		determineAgent
+	});
+}));
+//#endregion
+export default require_dist();
+export {};

package/dist/index.d.mts

@@ -0,0 +1,226 @@
+//#region src/core/types.d.ts
+/**
+ * Single source of truth for the types shared across the Nomai CLI.
+ *
+ * Design rule: ambient state (cwd, homedir) is injected through contexts and
+ * never read below the CLI layer, so every module is testable against temp dirs.
+ */
+type InstallScope = "project" | "global";
+/** Ambient paths, resolved once at the CLI layer and passed down. */
+interface ResolveContext {
+  /** The project the user runs nomai in (cwd or --dir override). */
+  projectDir: string;
+  /** os.homedir() in production, a temp dir in tests. */
+  homeDir: string;
+}
+/** One file of the payload, path relative to the harness install dir. */
+interface PayloadFile {
+  /** e.g. "skills/nomai/SKILL.md" */
+  relPath: string;
+  contents: Buffer;
+}
+/**
+ * Where the installable payload comes from. The default implementation
+ * downloads the Nomai GitHub repo; a local checkout is used for dev/tests.
+ * A future remote registry plugs in here.
+ */
+interface PayloadSource {
+  /** Human-readable origin recorded in the manifest, e.g. "owner/nomai#main". */
+  readonly description: string;
+  /** Canonical shared payload (contents of payload/shared/). */
+  readSharedFiles(): Promise<PayloadFile[]>;
+  /** Per-harness overlay (contents of payload/<harnessId>/), [] if none. */
+  readHarnessOverlay(harnessId: string): Promise<PayloadFile[]>;
+  /** Release temp resources. Safe to call more than once. */
+  dispose(): Promise<void>;
+}
+interface TransformContext extends ResolveContext {
+  scope: InstallScope;
+  nomaiVersion: string;
+}
+interface OperationContext extends ResolveContext {
+  scope: InstallScope;
+  /** Required for install/update. Uninstall and status work offline from the manifest. */
+  payload?: PayloadSource;
+  nomaiVersion: string;
+  dryRun: boolean;
+  /** Overrides the keep-user-modified-files protection on delete paths. */
+  force: boolean;
+}
+interface InstallResult {
+  installDir: string;
+  filesWritten: string[];
+  filesRemoved: string[];
+  /** True when the install was already up to date and nothing changed. */
+  skipped: boolean;
+}
+interface UninstallResult {
+  installDir: string;
+  /** True when there was no nomai manifest at this target. */
+  notInstalled: boolean;
+  filesRemoved: string[];
+  /** User-modified files kept in place (pass --force to remove them too). */
+  filesKept: string[];
+}
+interface HarnessStatus {
+  harnessId: string;
+  scope: InstallScope;
+  installDir: string;
+  /** Harness present at this scope (its config dir exists). */
+  detected: boolean;
+  /** Nomai manifest found at this target. */
+  installed: boolean;
+  installedVersion?: string;
+  installedAt?: string;
+  /** Manifest-listed files whose on-disk content no longer matches. */
+  modifiedFiles: string[];
+  /** Manifest-listed files that no longer exist. */
+  missingFiles: string[];
+}
+/**
+ * One AI coding harness (Claude Code, Codex, Cursor, ...).
+ *
+ * Create adapters with defineHarness() — it fills every method with defaults
+ * that delegate to the generic engine, so a typical adapter is ~5 lines.
+ * Every method stays overridable for harnesses that need custom behavior
+ * (e.g. merging hooks into a settings.json instead of copying files).
+ */
+interface HarnessAdapter {
+  /** Stable machine id used in --harness, manifests, and payload/<id>/. */
+  readonly id: string;
+  /** Name shown in the wizard, e.g. "Claude Code". */
+  readonly displayName: string;
+  /** The harness config dir name, e.g. ".claude". */
+  readonly configDirName: string;
+  /** Is this harness in use in the project? Default: <projectDir>/<configDirName> exists. */
+  detectProject(projectDir: string): Promise<boolean>;
+  /** Is this harness installed for the user? Default: <homeDir>/<configDirName> exists. */
+  detectGlobal(homeDir: string): Promise<boolean>;
+  /** Directory nomai writes into for a scope, e.g. <projectDir>/.claude. */
+  resolveInstallDir(scope: InstallScope, ctx: ResolveContext): string;
+  /**
+   * Per-harness compilation hook. Receives the merged payload (shared +
+   * harness overlay, overlay wins) and returns the files to write.
+   * Default: identity.
+   */
+  transformPayload(files: PayloadFile[], ctx: TransformContext): Promise<PayloadFile[]>;
+  install(ctx: OperationContext): Promise<InstallResult>;
+  uninstall(ctx: OperationContext): Promise<UninstallResult>;
+  status(ctx: OperationContext): Promise<HarnessStatus>;
+}
+interface DetectionResult {
+  harnessId: string;
+  project: boolean;
+  global: boolean;
+}
+interface DetectionReport {
+  results: DetectionResult[];
+  /** Ids detected at either scope — preseeds the wizard multiselect. */
+  detectedIds: string[];
+  /** Ids detected at project scope — drives the default scope answer. */
+  projectDetectedIds: string[];
+}
+/** Resolved answers of the install wizard (or of its flag-based bypass). */
+interface InstallPlan {
+  harnessIds: string[];
+  scope: InstallScope;
+}
+interface ManifestFileEntry {
+  /** Relative to the install dir, posix separators. */
+  path: string;
+  sha256: string;
+}
+/** Receipt written next to the installed files; drives idempotency, update, and clean uninstall. */
+interface Manifest {
+  schemaVersion: 1;
+  nomaiVersion: string;
+  /** PayloadSource description this install came from. */
+  source: string;
+  harness: string;
+  scope: InstallScope;
+  installedAt: string;
+  files: ManifestFileEntry[];
+}
+//#endregion
+//#region src/harnesses/define.d.ts
+interface HarnessConfig {
+  /** Stable machine id, e.g. "claude-code". */
+  id: string;
+  /** Name shown in the wizard, e.g. "Claude Code". */
+  displayName: string;
+  /** The harness config dir name, e.g. ".claude". */
+  configDirName: string;
+  /** Optional overrides — every default delegates to the generic engine. */
+  detectProject?: HarnessAdapter["detectProject"];
+  detectGlobal?: HarnessAdapter["detectGlobal"];
+  resolveInstallDir?: HarnessAdapter["resolveInstallDir"];
+  transformPayload?: HarnessAdapter["transformPayload"];
+  install?: HarnessAdapter["install"];
+  uninstall?: HarnessAdapter["uninstall"];
+  status?: HarnessAdapter["status"];
+}
+/**
+ * Build a HarnessAdapter from declarative config. A typical adapter is:
+ *
+ *   export const claudeCode = defineHarness({
+ *     id: "claude-code",
+ *     displayName: "Claude Code",
+ *     configDirName: ".claude",
+ *   });
+ *
+ * Harnesses that need per-harness compilation override transformPayload;
+ * harnesses with entirely custom mechanics (e.g. settings.json merges for
+ * hooks) can override install/uninstall/status wholesale.
+ */
+declare function defineHarness(config: HarnessConfig): HarnessAdapter;
+//#endregion
+//#region src/core/registry.d.ts
+declare function listHarnesses(): HarnessAdapter[];
+declare function getHarness(id: string): HarnessAdapter;
+//#endregion
+//#region src/core/detect.d.ts
+/**
+ * Ask every registered harness whether it is present at project and global
+ * scope. The report preseeds the wizard's harness multiselect and drives
+ * the defaults used by --yes.
+ */
+declare function detectHarnesses(ctx: ResolveContext): Promise<DetectionReport>;
+//#endregion
+//#region src/core/installer.d.ts
+/**
+ * Generic install/uninstall/status engine shared by all harness adapters.
+ * defineHarness() wires adapter methods to these functions by default;
+ * adapters with special needs override the methods instead.
+ *
+ * This module is the only place in the codebase that writes to disk.
+ */
+declare function installHarness(adapter: HarnessAdapter, ctx: OperationContext): Promise<InstallResult>;
+declare function uninstallHarness(adapter: HarnessAdapter, ctx: OperationContext): Promise<UninstallResult>;
+declare function statusHarness(adapter: HarnessAdapter, ctx: OperationContext): Promise<HarnessStatus>;
+//#endregion
+//#region src/core/payload.d.ts
+/**
+ * Default payload source: the Nomai GitHub repo, fetched as a codeload
+ * tarball of `main` at install time (same model as BuilderIO's
+ * `npx @agent-native/skills`). The npm package itself ships no payload.
+ */
+declare const DEFAULT_SOURCE = "A-MCode/nomai-installer";
+interface GitHubSourceRef {
+  owner: string;
+  repo: string;
+  ref?: string;
+}
+/** Accepts "owner/repo", "owner/repo#ref", or a github.com URL (optionally /tree/<ref>). */
+declare function parseGitHubSource(input: string): GitHubSourceRef | null;
+/**
+ * Turn a --source value (or the default) into a live PayloadSource:
+ * an existing local path wins, otherwise a GitHub download.
+ */
+declare function resolvePayloadSource(input?: string): Promise<PayloadSource>;
+//#endregion
+//#region src/core/manifest.d.ts
+declare const MANIFEST_FILENAME = "nomai-manifest.json";
+/** @returns null when no manifest exists; throws on a corrupt/foreign one. */
+declare function readManifest(installDir: string): Promise<Manifest | null>;
+//#endregion
+export { DEFAULT_SOURCE, type DetectionReport, type DetectionResult, type HarnessAdapter, type HarnessConfig, type HarnessStatus, type InstallPlan, type InstallResult, type InstallScope, MANIFEST_FILENAME, type Manifest, type ManifestFileEntry, type OperationContext, type PayloadFile, type PayloadSource, type ResolveContext, type TransformContext, type UninstallResult, defineHarness, detectHarnesses, getHarness, installHarness, listHarnesses, parseGitHubSource, readManifest, resolvePayloadSource, statusHarness, uninstallHarness };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as getHarness, c as installHarness, d as MANIFEST_FILENAME, f as readManifest, i as detectHarnesses, l as statusHarness, n as parseGitHubSource, o as listHarnesses, r as resolvePayloadSource, s as defineHarness, t as DEFAULT_SOURCE, u as uninstallHarness } from "./payload-DdBYzrl3.mjs";
+export { DEFAULT_SOURCE, MANIFEST_FILENAME, defineHarness, detectHarnesses, getHarness, installHarness, listHarnesses, parseGitHubSource, readManifest, resolvePayloadSource, statusHarness, uninstallHarness };