oneagent 0.1.0

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "oneagent",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "One source of truth for AI agent rules — distributed via symlinks to Claude, Cursor, Windsurf, Copilot, OpenCode",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/moskalakamil/oneagent"
+  },
+  "bin": {
+    "oneagent": "./src/index.ts"
+  },
+  "module": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "latest",
+    "@moskala/oneagent-core": "0.1.0",
+    "citty": "latest"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  }
+}

package/src/commands/generate.ts

@@ -0,0 +1,33 @@
+import { defineCommand } from "citty";
+import { spinner } from "@clack/prompts";
+import { readConfig, generate } from "@moskala/oneagent-core";
+
+export default defineCommand({
+  meta: {
+    name: "generate",
+    description: "Generate symlinks and agent-specific files",
+  },
+  async run() {
+    const root = process.cwd();
+
+    let config;
+    try {
+      config = await readConfig(root);
+    } catch {
+      console.error("Error: No .oneagent/config.yml found. Run `oneagent init` first.");
+      process.exit(1);
+    }
+
+    const s = spinner();
+    s.start("Generating...");
+
+    try {
+      await generate(root, config);
+      s.stop("Generated successfully.");
+    } catch (error) {
+      s.stop("Generation failed.");
+      console.error(error);
+      process.exit(1);
+    }
+  },
+});

package/src/commands/init.ts

@@ -0,0 +1,186 @@
+import { defineCommand } from "citty";
+import {
+  intro,
+  outro,
+  confirm,
+  multiselect,
+  select,
+  spinner,
+  note,
+  isCancel,
+} from "@clack/prompts";
+import path from "path";
+import fs from "fs/promises";
+import { timeAgo } from "../utils.ts";
+import {
+  configExists,
+  writeConfig,
+  detectExistingFiles,
+  filesHaveSameContent,
+  generate,
+  type AgentTarget,
+  type Config,
+  type DetectedFile,
+} from "@moskala/oneagent-core";
+
+const DOTAI_META_RULE = `---
+applyTo: "**"
+---
+# oneagent
+
+This project uses [oneagent](https://github.com/moskalakamil/oneagent) to manage AI agent configuration.
+
+Rules are stored in \`.oneagent/rules/\` and distributed to agents automatically via symlinks or generated files.
+
+To add a new rule, create a \`.md\` file in \`.oneagent/rules/\` with optional frontmatter:
+
+\`\`\`md
+---
+applyTo: "**/*.ts"
+---
+# Rule name
+
+Rule content here.
+\`\`\`
+
+Then run \`dotai generate\` to distribute the rule to all configured agents.
+`;
+
+function cancelAndExit(): never {
+  outro("Cancelled.");
+  process.exit(0);
+}
+
+async function chooseContent(detected: DetectedFile[]): Promise<string> {
+  if (detected.length === 0) return "";
+
+  if (detected.length === 1) {
+    const file = detected[0]!;
+    const result = await confirm({
+      message: `Found ${file.relativePath} (${timeAgo(file.modifiedAt)}). Import its content into .oneagent/instructions.md?`,
+    });
+    if (isCancel(result)) cancelAndExit();
+    return result ? file.content : "";
+  }
+
+  if (filesHaveSameContent(detected)) {
+    const result = await confirm({
+      message: `Found ${detected.length} files with identical content. Import?`,
+    });
+    if (isCancel(result)) cancelAndExit();
+    return result ? detected[0]!.content : "";
+  }
+
+  // Scenario D — multiple files, different content
+  note(
+    detected.map((f) => `  • ${f.relativePath}  ${timeAgo(f.modifiedAt)}`).join("\n"),
+    "Multiple files with different content found",
+  );
+
+  const result = await select({
+    message: "How would you like to handle existing content?",
+    options: [
+      { value: "merge", label: "Merge all files", hint: "Combine all content" },
+      ...detected.map((f, i) => ({
+        value: `file:${i}`,
+        label: `Use ${f.relativePath}`,
+        hint: `${timeAgo(f.modifiedAt)}`,
+      })),
+      { value: "skip", label: "Skip", hint: "Start with empty instructions" },
+    ],
+  });
+
+  if (isCancel(result)) cancelAndExit();
+
+  if (result === "skip") return "";
+  if (result === "merge") return detected.map((f) => f.content).join("\n\n---\n\n");
+
+  const index = parseInt((result as string).replace("file:", ""), 10);
+  return detected[index]!.content;
+}
+
+async function pickTargets(): Promise<AgentTarget[]> {
+  const result = await multiselect<AgentTarget>({
+    message: `Which AI agents do you want to support?
+\x1b[90m · Space to toggle · Enter to confirm\x1b[39m`,
+    options: [
+      { value: "claude", label: "Claude Code", hint: "CLAUDE.md + .claude/rules/" },
+      { value: "cursor", label: "Cursor", hint: "AGENTS.md + .cursor/rules/" },
+      { value: "windsurf", label: "Windsurf", hint: ".windsurfrules + .windsurf/rules/" },
+      { value: "opencode", label: "OpenCode", hint: "AGENTS.md + opencode.json" },
+      { value: "copilot", label: "GitHub Copilot", hint: ".github/instructions/*.instructions.md" },
+    ],
+    initialValues: ["claude"],
+    required: true,
+  });
+
+  if (isCancel(result)) cancelAndExit();
+  return result;
+}
+
+async function backupFiles(root: string, files: DetectedFile[]): Promise<void> {
+  if (files.length === 0) return;
+  const backupDir = path.join(root, ".oneagent/backup");
+  await fs.mkdir(backupDir, { recursive: true });
+  for (const file of files) {
+    const safeName = file.relativePath.replace(/\//g, "_");
+    await Bun.write(path.join(backupDir, safeName), file.content);
+  }
+}
+
+export default defineCommand({
+  meta: {
+    name: "init",
+    description: "Initialize oneagent in the current project",
+  },
+  async run() {
+    intro("oneagent init");
+
+    const root = process.cwd();
+
+    if (await configExists(root)) {
+      note("Already initialized. Run `oneagent generate` to sync.", "oneagent");
+      outro("Done.");
+      return;
+    }
+
+    const detected = await detectExistingFiles(root);
+    const content = await chooseContent(detected);
+    const targets = await pickTargets();
+
+    const s = spinner();
+    s.start("Setting up .oneagent/ directory...");
+
+    await fs.mkdir(path.join(root, ".oneagent/rules"), { recursive: true });
+    await fs.mkdir(path.join(root, ".oneagent/skills"), { recursive: true });
+
+    await backupFiles(root, detected);
+
+    const config: Config = { version: 1, targets };
+    await writeConfig(root, config);
+
+    const instructionsContent =
+      content.trim() ? content : "# Project Instructions\n\nAdd your AI instructions here.\n";
+    await Bun.write(path.join(root, ".oneagent/instructions.md"), instructionsContent);
+    await Bun.write(path.join(root, ".oneagent/rules/oneagent.md"), DOTAI_META_RULE);
+
+    s.stop("Directory structure created.");
+
+    const s2 = spinner();
+    s2.start("Generating symlinks and agent files...");
+    await generate(root, config);
+    s2.stop("Done.");
+
+    const lines = [
+      "Created .oneagent/instructions.md",
+      "Created .oneagent/rules/oneagent.md",
+      ...targets.map((t) => `Configured: ${t}`),
+      ...(detected.length > 0
+        ? [`Backed up ${detected.length} file(s) to .oneagent/backup/`]
+        : []),
+    ];
+    note(lines.map((l) => `  • ${l}`).join("\n"), "Setup complete");
+
+    outro("Run `oneagent status` to verify your setup.");
+  },
+});

package/src/commands/status.ts

@@ -0,0 +1,47 @@
+import { defineCommand } from "citty";
+import { readConfig, checkStatus } from "@moskala/oneagent-core";
+
+export default defineCommand({
+  meta: {
+    name: "status",
+    description: "Check status of symlinks and generated files",
+  },
+  async run() {
+    const root = process.cwd();
+
+    let config;
+    try {
+      config = await readConfig(root);
+    } catch {
+      console.error("Error: No .oneagent/config.yml found. Run `oneagent init` first.");
+      process.exit(1);
+    }
+
+    const status = await checkStatus(root, config);
+
+    console.log("\nSymlinks:");
+    for (const s of status.symlinks) {
+      const icon = !s.exists ? "✗" : s.valid ? "✓" : "⚠";
+      const text = !s.exists ? "missing" : s.valid ? "valid" : "broken (wrong target)";
+      console.log(`  ${icon} ${s.label} — ${text}`);
+    }
+
+    if (status.generatedFiles.length > 0) {
+      console.log("\nGenerated files (Copilot):");
+      for (const f of status.generatedFiles) {
+        const icon = !f.exists ? "✗" : f.upToDate ? "✓" : "⚠";
+        const text = !f.exists ? "missing" : f.upToDate ? "up to date" : "outdated";
+        console.log(`  ${icon} ${f.path} — ${text}`);
+      }
+    }
+
+    if (config.targets.includes("opencode")) {
+      const { opencode } = status;
+      const icon = !opencode.exists ? "✗" : opencode.valid ? "✓" : "⚠";
+      const text = !opencode.exists ? "missing" : opencode.valid ? "valid" : "invalid";
+      console.log(`\nOpenCode:\n  ${icon} opencode.json — ${text}`);
+    }
+
+    console.log();
+  },
+});

package/src/index.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env bun
+import { defineCommand, runMain } from "citty";
+
+const main = defineCommand({
+  meta: {
+    name: "oneagent",
+    description: "One source of truth for AI agent rules",
+  },
+  subCommands: {
+    init: () => import("./commands/init.ts").then((r) => r.default),
+    generate: () => import("./commands/generate.ts").then((r) => r.default),
+    status: () => import("./commands/status.ts").then((r) => r.default),
+  },
+});
+
+runMain(main);

package/src/utils.ts

@@ -0,0 +1,13 @@
+export function timeAgo(date: Date): string {
+  const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
+  if (seconds < 60) return `${seconds}s ago`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  if (days < 30) return `${days}d ago`;
+  const months = Math.floor(days / 30);
+  if (months < 12) return `${months}mo ago`;
+  return `${Math.floor(months / 12)}y ago`;
+}