@newtype-ai/nit 0.2.3 → 0.2.5

package/README.md

@@ -57,7 +57,7 @@ nit push --all
 | `nit checkout <branch>` | Switch branch (overwrites agent-card.json) |
 | `nit push [--all]` | Push branch(es) to remote |
 | `nit sign "msg"` | Sign a message with your Ed25519 key |
-| `nit sign --login <domain>` | Generate login payload for an app |
+| `nit sign --login <domain>` | Auto-switch to domain branch + generate login payload |
 | `nit remote` | Show remote URL and credential status |
 | `nit remote add <name> <url>` | Add a new remote |
 | `nit remote set-url <name> <url>` | Change a remote's URL |
@@ -84,7 +84,9 @@ Each branch is a different agent card for a different platform. Branch name = ro
 
 ### Skill Resolution
 
-At commit time, nit discovers SKILL.md files from all major agent frameworks:
+Your card can store skills as **pointers** — just `{ "id": "skill-name" }` — resolved from SKILL.md files at commit time. SKILL.md is the single source of truth when present.
+
+nit auto-discovers your skills directory from all major agent frameworks:
 
 - `.claude/skills/` — Claude Code
 - `.cursor/skills/` — Cursor
@@ -92,7 +94,7 @@ At commit time, nit discovers SKILL.md files from all major agent frameworks:
 - `.codex/skills/` — OpenAI Codex
 - `.agents/skills/` — Generic
 
-Skills referenced in your card are resolved against these files, and the committed card contains a self-contained snapshot.
+The discovered path is stored in `.nit/config`. When `nit sign --login <domain>` creates a new branch, it auto-creates a SKILL.md template and adds a pointer to the card. The committed card always contains fully resolved, self-contained skill data.
 
 ### Remote Protocol
 
@@ -116,10 +118,11 @@ nit remote set-url origin https://my-server.com
 your-project/
 ├── .nit/                    # nit repository (gitignored)
 │   ├── HEAD                 # Current branch ref
-│   ├── config               # Remote URL and credentials
+│   ├── config               # Remote URL, credentials, skills directory
 │   ├── identity/
 │   │   ├── agent.pub        # Ed25519 public key
-│   │   └── agent.key        # Ed25519 private key (0600)
+│   │   ├── agent.key        # Ed25519 private key (0600)
+│   │   └── agent-id         # UUIDv5 derived from public key
 │   ├── objects/              # Content-addressable store
 │   └── refs/heads/           # Branch pointers
 ├── agent-card.json          # Working copy (changes with checkout)
@@ -129,12 +132,15 @@ your-project/
 ## Programmatic API
 
 ```typescript
-import { init, commit, checkout, branch, push, status } from '@newtype-ai/nit';
+import { init, commit, checkout, branch, push, status, sign, loginPayload } from '@newtype-ai/nit';
 
 await init();
-await branch('faam.io');
-await checkout('faam.io');
-// modify agent-card.json...
+
+// Log into an app (auto-creates and switches to domain branch)
+const payload = await loginPayload('faam.io');
+// → { agent_id, domain, timestamp, signature, switchedBranch, createdSkill }
+
+// Customize card, then commit & push
 await commit('FAAM config');
 await push({ all: true });
 ```

package/dist/{chunk-2ZHTOY2J.js → chunk-U6PEH4IJ.js}

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { promises as fs6, statSync } from "fs";
-import { join as join6, basename as basename2, resolve } from "path";
+import { join as join6, basename as basename2, resolve as resolve2 } from "path";
 
 // src/objects.ts
 import { createHash } from "crypto";
@@ -312,8 +312,70 @@ function uuidv5(name, namespace) {
 
 // src/skills.ts
 import { promises as fs4 } from "fs";
-import { join as join4 } from "path";
+import { join as join4, resolve } from "path";
 import { homedir } from "os";
+var FRAMEWORK_MARKERS = [
+  { marker: ".claude", skillsPath: ".claude/skills" },
+  { marker: ".cursor", skillsPath: ".cursor/skills" },
+  { marker: ".codex", skillsPath: ".codex/skills" },
+  { marker: ".windsurf", skillsPath: ".windsurf/skills" },
+  { marker: ".openclaw", skillsPath: ".agents/skills" }
+];
+var GLOBAL_SKILLS_DIRS = [
+  { marker: ".claude", skillsPath: ".claude/skills" },
+  { marker: ".codex", skillsPath: ".codex/skills" },
+  { marker: ".codeium", skillsPath: ".codeium/windsurf/skills" }
+];
+async function discoverSkillsDir(projectDir2) {
+  const absProject = resolve(projectDir2);
+  const home = homedir();
+  for (const { marker, skillsPath } of FRAMEWORK_MARKERS) {
+    if (absProject.includes(`/${marker}/`) || absProject.includes(`/${marker}`)) {
+      return join4(absProject, skillsPath);
+    }
+  }
+  for (const { marker, skillsPath } of FRAMEWORK_MARKERS) {
+    try {
+      const stat = await fs4.stat(join4(absProject, marker));
+      if (stat.isDirectory()) {
+        return join4(absProject, skillsPath);
+      }
+    } catch {
+    }
+  }
+  for (const { marker, skillsPath } of GLOBAL_SKILLS_DIRS) {
+    try {
+      const stat = await fs4.stat(join4(home, marker));
+      if (stat.isDirectory()) {
+        return join4(home, skillsPath);
+      }
+    } catch {
+    }
+  }
+  return join4(absProject, ".agents", "skills");
+}
+async function createSkillTemplate(skillsDir, domain) {
+  const skillId = domain.replace(/\./g, "-");
+  const skillDir = join4(skillsDir, skillId);
+  const skillPath = join4(skillDir, "SKILL.md");
+  try {
+    await fs4.access(skillPath);
+    return skillId;
+  } catch {
+  }
+  await fs4.mkdir(skillDir, { recursive: true });
+  const template = `---
+name: ${skillId}
+description: Skills and context for ${domain}
+---
+
+# ${skillId}
+
+Configure your skills and context for ${domain} here.
+`;
+  await fs4.writeFile(skillPath, template, "utf-8");
+  return skillId;
+}
 async function discoverSkills(projectDir2) {
   const home = homedir();
   const searchDirs = [
@@ -624,33 +686,49 @@ async function getRemoteUrl(nitDir, remoteName) {
   const config = await readConfig(nitDir);
   return config.remotes[remoteName]?.url ?? null;
 }
+async function getSkillsDir(nitDir) {
+  const config = await readConfig(nitDir);
+  return config.skillsDir ?? null;
+}
 function parseConfig(raw) {
   const remotes = {};
+  let currentSection = null;
   let currentRemote = null;
+  let skillsDir;
   for (const line of raw.split("\n")) {
     const trimmed = line.trim();
     if (trimmed === "" || trimmed.startsWith("#")) continue;
-    const sectionMatch = trimmed.match(/^\[remote\s+"([^"]+)"\]$/);
-    if (sectionMatch) {
-      currentRemote = sectionMatch[1];
+    const remoteMatch = trimmed.match(/^\[remote\s+"([^"]+)"\]$/);
+    if (remoteMatch) {
+      currentSection = "remote";
+      currentRemote = remoteMatch[1];
       if (!remotes[currentRemote]) {
         remotes[currentRemote] = {};
       }
       continue;
     }
-    if (currentRemote !== null) {
-      const kvMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
-      if (kvMatch) {
-        const [, key, value] = kvMatch;
+    if (trimmed === "[skills]") {
+      currentSection = "skills";
+      currentRemote = null;
+      continue;
+    }
+    const kvMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
+    if (kvMatch) {
+      const [, key, value] = kvMatch;
+      if (currentSection === "remote" && currentRemote !== null) {
         if (key === "url") {
           remotes[currentRemote].url = value.trim();
         } else if (key === "credential") {
           remotes[currentRemote].credential = value.trim();
         }
+      } else if (currentSection === "skills") {
+        if (key === "dir") {
+          skillsDir = value.trim();
+        }
       }
     }
   }
-  return { remotes };
+  return { remotes, skillsDir };
 }
 function serializeConfig(config) {
   const lines = [];
@@ -664,6 +742,11 @@ function serializeConfig(config) {
     }
     lines.push("");
   }
+  if (config.skillsDir) {
+    lines.push("[skills]");
+    lines.push(`  dir = ${config.skillsDir}`);
+    lines.push("");
+  }
   return lines.join("\n");
 }
 
@@ -672,7 +755,7 @@ var NIT_DIR = ".nit";
 var CARD_FILE = "agent-card.json";
 var DEFAULT_API_BASE = "https://api.newtype-ai.org";
 function findNitDir(startDir) {
-  let dir = resolve(startDir || process.cwd());
+  let dir = resolve2(startDir || process.cwd());
   while (true) {
     const candidate = join6(dir, NIT_DIR);
     try {
@@ -680,7 +763,7 @@ function findNitDir(startDir) {
       if (s.isDirectory()) return candidate;
     } catch {
     }
-    const parent = resolve(dir, "..");
+    const parent = resolve2(dir, "..");
     if (parent === dir) {
       throw new Error(
         "Not a nit repository (or any parent directory). Run `nit init` first."
@@ -690,7 +773,7 @@ function findNitDir(startDir) {
   }
 }
 function projectDir(nitDir) {
-  return resolve(nitDir, "..");
+  return resolve2(nitDir, "..");
 }
 async function readWorkingCard(nitDir) {
   const cardPath = join6(projectDir(nitDir), CARD_FILE);
@@ -720,7 +803,7 @@ async function getAuthorName(nitDir) {
   }
 }
 async function init(options) {
-  const projDir = resolve(options?.projectDir || process.cwd());
+  const projDir = resolve2(options?.projectDir || process.cwd());
   const nitDir = join6(projDir, NIT_DIR);
   try {
     await fs6.access(nitDir);
@@ -781,14 +864,17 @@ async function init(options) {
   await setBranch(nitDir, "main", commitHash);
   await setHead(nitDir, "main");
   await fs6.writeFile(join6(nitDir, "logs", "HEAD"), "", "utf-8");
+  const skillsDir = await discoverSkillsDir(projDir);
   await writeConfig(nitDir, {
-    remotes: { origin: { url: DEFAULT_API_BASE } }
+    remotes: { origin: { url: DEFAULT_API_BASE } },
+    skillsDir
   });
   return {
     agentId,
     publicKey: publicKeyField,
     cardUrl: card.url,
-    skillsFound
+    skillsFound,
+    skillsDir
   };
 }
 async function status(options) {
@@ -858,15 +944,29 @@ async function sign2(message, options) {
 async function loginPayload(domain, options) {
   const nitDir = findNitDir(options?.projectDir);
   let switchedBranch;
+  let createdSkill;
   const currentBranch = await getCurrentBranch(nitDir);
   if (currentBranch !== domain) {
-    const existing = await getBranch(nitDir, domain);
-    if (!existing) {
+    const isNew = !await getBranch(nitDir, domain);
+    if (isNew) {
       const headHash = await resolveHead(nitDir);
       await setBranch(nitDir, domain, headHash);
     }
     await checkout(domain, options);
     switchedBranch = domain;
+    if (isNew) {
+      const skillsDir = await getSkillsDir(nitDir);
+      if (skillsDir) {
+        const skillId = await createSkillTemplate(skillsDir, domain);
+        const card = await readWorkingCard(nitDir);
+        const hasSkill = card.skills.some((s) => s.id === skillId);
+        if (!hasSkill) {
+          card.skills.push({ id: skillId });
+          await writeWorkingCard(nitDir, card);
+          createdSkill = skillId;
+        }
+      }
+    }
   }
   const agentId = await loadAgentId(nitDir);
   const timestamp = Math.floor(Date.now() / 1e3);
@@ -874,7 +974,7 @@ async function loginPayload(domain, options) {
 ${domain}
 ${timestamp}`;
   const signature = await signMessage(nitDir, message);
-  return { agent_id: agentId, domain, timestamp, signature, switchedBranch };
+  return { agent_id: agentId, domain, timestamp, signature, switchedBranch, createdSkill };
 }
 async function commit(message, options) {
   const nitDir = findNitDir(options?.projectDir);

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
   remoteSetUrl,
   sign,
   status
-} from "./chunk-2ZHTOY2J.js";
+} from "./chunk-U6PEH4IJ.js";
 
 // src/cli.ts
 var bold = (s) => `\x1B[1m${s}\x1B[0m`;
@@ -80,6 +80,7 @@ async function cmdInit() {
   console.log(`  Agent ID:    ${green(result.agentId)}`);
   console.log(`  Public key:  ${dim(result.publicKey)}`);
   console.log(`  Card URL:    ${result.cardUrl}`);
+  console.log(`  Skills dir:  ${dim(result.skillsDir)}`);
   if (result.skillsFound.length > 0) {
     console.log(`  Skills:      ${result.skillsFound.join(", ")}`);
   } else {
@@ -233,7 +234,10 @@ async function cmdSign(args) {
     if (payload.switchedBranch) {
       console.error(`Switched to branch '${payload.switchedBranch}'`);
     }
-    const { switchedBranch: _, ...output } = payload;
+    if (payload.createdSkill) {
+      console.error(`Created skill template '${payload.createdSkill}'`);
+    }
+    const { switchedBranch: _s, createdSkill: _c, ...output } = payload;
     console.log(JSON.stringify(output, null, 2));
     return;
   }

package/dist/index.d.ts

@@ -36,6 +36,8 @@ interface NitRemoteConfig {
 interface NitConfig {
     /** Keyed by remote name (e.g. "origin") */
     remotes: Record<string, NitRemoteConfig>;
+    /** Discovered skills directory path */
+    skillsDir?: string;
 }
 /** A2A-compatible agent card. */
 interface AgentCard {
@@ -56,11 +58,13 @@ interface AgentCard {
         url?: string;
     };
 }
-/** A single skill entry in an agent card. */
+/** A single skill entry in an agent card.
+ *  Can be a full skill (all fields) or a pointer (just id).
+ *  At commit time, pointers are resolved from SKILL.md files. */
 interface AgentCardSkill {
     id: string;
-    name: string;
-    description: string;
+    name?: string;
+    description?: string;
     tags?: string[];
     examples?: string[];
     inputModes?: string[];
@@ -200,6 +204,7 @@ interface InitResult {
     publicKey: string;
     cardUrl: string;
     skillsFound: string[];
+    skillsDir: string;
 }
 /**
  * Initialize a new nit repository in the project directory.
@@ -235,6 +240,7 @@ declare function loginPayload(domain: string, options?: {
     projectDir?: string;
 }): Promise<LoginPayload & {
     switchedBranch?: string;
+    createdSkill?: string;
 }>;
 /**
  * Snapshot the current agent-card.json as a new commit.

package/dist/index.js

@@ -25,7 +25,7 @@ import {
   signMessage,
   status,
   verifySignature
-} from "./chunk-2ZHTOY2J.js";
+} from "./chunk-U6PEH4IJ.js";
 export {
   NIT_NAMESPACE,
   branch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newtype-ai/nit",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Version control for agent cards",
   "type": "module",
   "bin": {