@apart-tech/apart-intelligence 1.0.9 → 1.0.11

package/dist/commands/codebase.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function codebaseCommand(program: Command): void;
+//# sourceMappingURL=codebase.d.ts.map

package/dist/commands/codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase.d.ts","sourceRoot":"","sources":["../../src/commands/codebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,QAkI/C"}

package/dist/commands/codebase.js

@@ -0,0 +1,110 @@
+import { existsSync, mkdirSync, copyFileSync } from "fs";
+import { join, resolve } from "path";
+import chalk from "chalk";
+import prompts from "prompts";
+const SKILLS = ["capture", "document", "sync"];
+function findSkillsSource() {
+    // Skills are bundled in the published package under skills/
+    const pkgSkills = resolve(new URL(".", import.meta.url).pathname, "..", "..", "skills");
+    if (existsSync(pkgSkills))
+        return pkgSkills;
+    // Fallback for development: look in the repo root
+    const repoSkills = resolve(new URL(".", import.meta.url).pathname, "..", "..", "..", "..", ".claude", "skills");
+    if (existsSync(repoSkills))
+        return repoSkills;
+    throw new Error("Could not find bundled skills. Reinstall @apart-tech/apart-intelligence.");
+}
+export function codebaseCommand(program) {
+    const codebase = program
+        .command("codebase")
+        .description("Manage Apart Intelligence in a codebase");
+    codebase
+        .command("init")
+        .description("Install Apart Intelligence skills (capture, document, sync) into the current codebase")
+        .option("-y, --yes", "Skip confirmation prompt")
+        .action(async (opts) => {
+        const targetDir = process.cwd();
+        const claudeDir = join(targetDir, ".claude");
+        const skillsDir = join(claudeDir, "skills");
+        console.log(chalk.bold("\nApart Intelligence — Codebase Setup\n"));
+        // Check which skills already exist
+        const existing = SKILLS.filter((s) => existsSync(join(skillsDir, s, "SKILL.md")));
+        const toInstall = SKILLS.filter((s) => !existsSync(join(skillsDir, s, "SKILL.md")));
+        if (existing.length > 0) {
+            console.log(chalk.dim("  Already installed:"));
+            for (const s of existing) {
+                console.log(chalk.dim(`    /${s}`));
+            }
+        }
+        if (toInstall.length === 0) {
+            console.log(chalk.green("\n  All skills are already installed.\n"));
+            process.exit(0);
+        }
+        console.log("  Skills to install:");
+        for (const s of toInstall) {
+            console.log(`    ${chalk.cyan(`/${s}`)}`);
+        }
+        console.log();
+        if (!opts.yes) {
+            const { proceed } = await prompts({
+                type: "confirm",
+                name: "proceed",
+                message: `Install ${toInstall.length} skill(s) into ${chalk.dim(".claude/skills/")}?`,
+                initial: true,
+            });
+            if (!proceed) {
+                console.log(chalk.dim("Aborted."));
+                process.exit(0);
+            }
+        }
+        // Find the source skills
+        let source;
+        try {
+            source = findSkillsSource();
+        }
+        catch (err) {
+            console.error(chalk.red(err.message));
+            process.exit(1);
+        }
+        // Copy skills
+        for (const skill of toInstall) {
+            const srcFile = join(source, skill, "SKILL.md");
+            const destDir = join(skillsDir, skill);
+            const destFile = join(destDir, "SKILL.md");
+            if (!existsSync(srcFile)) {
+                console.error(chalk.yellow(`  ⚠ Skill source not found: ${skill}, skipping`));
+                continue;
+            }
+            mkdirSync(destDir, { recursive: true });
+            copyFileSync(srcFile, destFile);
+            console.log(chalk.green(`  ✓ /${skill}`));
+        }
+        console.log(chalk.bold("\n✓ Skills installed!\n"));
+        console.log("  Available commands in Claude Code:");
+        console.log(chalk.cyan("    /capture <knowledge>      Quick-capture a decision, process, or policy"));
+        console.log(chalk.cyan("    /document [path|range]    Generate docs from recent changes"));
+        console.log(chalk.cyan("    /sync [range]             Incrementally sync code changes to the graph"));
+        console.log();
+        process.exit(0);
+    });
+    codebase
+        .command("status")
+        .description("Show which Apart Intelligence skills are installed")
+        .action(() => {
+        const skillsDir = join(process.cwd(), ".claude", "skills");
+        console.log(chalk.bold("\nApart Intelligence — Codebase Status\n"));
+        for (const skill of SKILLS) {
+            const installed = existsSync(join(skillsDir, skill, "SKILL.md"));
+            const icon = installed
+                ? chalk.green("✓")
+                : chalk.dim("✗");
+            const label = installed
+                ? chalk.white(`/${skill}`)
+                : chalk.dim(`/${skill}`);
+            console.log(`  ${icon} ${label}`);
+        }
+        console.log();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=codebase.js.map

package/dist/commands/codebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase.js","sourceRoot":"","sources":["../../src/commands/codebase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAe,MAAM,IAAI,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAE/C,SAAS,gBAAgB;IACvB,4DAA4D;IAC5D,MAAM,SAAS,GAAG,OAAO,CACvB,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EACtC,IAAI,EACJ,IAAI,EACJ,QAAQ,CACT,CAAC;IACF,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,kDAAkD;IAClD,MAAM,UAAU,GAAG,OAAO,CACxB,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EACtC,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,QAAQ,CACT,CAAC;IACF,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAE9C,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yCAAyC,CAAC,CAAC;IAE1D,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,uFAAuF,CACxF;SACA,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CACtD,CAAC;QAEF,mCAAmC;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAC3C,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CACnD,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;gBAChC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,WAAW,SAAS,CAAC,MAAM,kBAAkB,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG;gBACrF,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,cAAc;QACd,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAE3C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,+BAA+B,KAAK,YAAY,CAAC,CAC/D,CAAC;gBACF,SAAS;YACX,CAAC;YAED,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,4EAA4E,CAC7E,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,iEAAiE,CAClE,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CACR,4EAA4E,CAC7E,CACF,CAAC;QACF,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;QAEpE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,SAAS;gBACpB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;gBAClB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,SAAS;gBACrB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;gBAC1B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.js

@@ -27,6 +27,7 @@ import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
 import { whoamiCommand } from "./commands/whoami.js";
 import { workspaceCommand } from "./commands/workspace.js";
+import { codebaseCommand } from "./commands/codebase.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const program = new Command();
@@ -60,5 +61,6 @@ loginCommand(program);
 logoutCommand(program);
 whoamiCommand(program);
 workspaceCommand(program);
+codebaseCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,37 +1,38 @@
 {
   "name": "@apart-tech/apart-intelligence",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Apart Intelligence — the knowledge graph CLI",
   "type": "module",
   "bin": {
     "ai": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit",
-    "test": "vitest run"
-  },
   "dependencies": {
     "@prisma/client": "^6.6.0",
     "@prisma/extension-accelerate": "^3.0.1",
-    "@apart-tech/intelligence-core": "^1.0.2",
     "chalk": "^5.4.0",
     "commander": "^13.0.0",
     "prompts": "^2.4.2",
     "dotenv": "^17.3.1",
     "typescript": "^5.7.0",
-    "yaml": "^2.6.0"
+    "yaml": "^2.6.0",
+    "@apart-tech/intelligence-core": "1.0.2"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "@types/prompts": "^2.4.9",
     "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run"
   }
-}
+}

package/skills/capture/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: capture
+description: Quick-capture a decision, process, or knowledge node into the Apart Intelligence knowledge graph
+disable-model-invocation: true
+allowed-tools: Bash
+---
+
+# /capture — Quick Knowledge Capture
+
+Capture a piece of knowledge (decision, process, policy, architecture note) into the Apart Intelligence knowledge graph.
+
+## Input
+
+The user provides `$ARGUMENTS` — a free-text description of what to capture.
+
+## Steps
+
+1. **Classify** the input into one of these node types based on content:
+   - `decision` — a choice that was made and why (e.g., "We chose Hono for the API framework because...")
+   - `process` — a workflow or procedure (e.g., "To deploy, run X then Y...")
+   - `policy` — a rule or constraint (e.g., "All API endpoints must validate input with Zod")
+   - `architecture` — a structural/design description (e.g., "The CLI uses a provider pattern for DB vs API access")
+   - `note` — anything that doesn't fit the above
+
+2. **Generate a concise title** (under 80 characters) summarizing the knowledge.
+
+3. **Check available domains** to find the best fit:
+   ```bash
+   ai domains list -f json
+   ```
+   Pick the most relevant domain slug, or omit if none fit.
+
+4. **Create the node** via the CLI:
+   ```bash
+   ai add "<content>" --type <type> --title "<title>" [-d <domain-slug>] -f json
+   ```
+   Where `<content>` is the full user input (the `$ARGUMENTS`), expanded into a well-structured markdown body if the input is terse.
+
+5. **Report the result** — show the node ID, type, title, and status. If the user might want to link this to other nodes, mention `ai edges add`.
+
+## Example
+
+User: `/capture We decided to use Hono instead of Express for the API server because it's lightweight, has native TypeScript support, and works well with Cloudflare Workers`
+
+→ Type: `decision`
+→ Title: "Use Hono over Express for API server"
+→ Content: the full text above, formatted as markdown with rationale
+→ Domain: `engineering/backend` (if it exists)
+
+## Error Handling
+
+- If `ai` is not found, tell the user to install or link the CLI (`npm link` from the project root or `npx ai`).
+- If domain lookup fails, create the node without a domain.
+- If node creation fails, show the full error output.

package/skills/document/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: document
+description: Analyze recent changes and generate documentation nodes in the knowledge graph
+disable-model-invocation: true
+context: fork
+allowed-tools: Bash, Read, Glob, Grep
+---
+
+# /document — Generate Documentation Nodes from Changes
+
+Analyze recent code changes and generate knowledge graph nodes for significant undocumented decisions, architecture, and processes.
+
+## Input
+
+`$ARGUMENTS` is optional:
+- If a **path** is provided (e.g., `/document packages/api/`), scope analysis to that directory.
+- If a **commit range** is provided (e.g., `/document abc123..HEAD`), use that range.
+- If empty, default to the last 5 commits on the current branch.
+
+## Steps
+
+### 1. Determine Scope
+
+```bash
+# If path provided, get recent changes in that path
+git log --oneline -10 -- <path>
+git diff HEAD~5 -- <path>
+
+# If commit range provided
+git log --oneline <range>
+git diff <range>
+
+# Default: last 5 commits
+git log --oneline -5
+git diff HEAD~5
+```
+
+### 2. Analyze Changes
+
+Read the diff output and identify changes that represent:
+- **Architectural decisions** — new patterns, framework choices, structural changes
+- **Process changes** — new workflows, deployment changes, CI/CD modifications
+- **Significant refactors** — renamed concepts, reorganized modules, new abstractions
+
+Skip routine changes: formatting, minor bug fixes, dependency bumps, test additions, config tweaks.
+
+### 3. Search Existing Knowledge
+
+For each significant change identified, search the knowledge graph to avoid duplicates:
+
+```bash
+ai search "<description of change>" -f json
+```
+
+If a relevant node already exists, skip it or note it needs updating.
+
+### 4. Create Nodes
+
+For each undocumented significant change:
+
+```bash
+ai add "<detailed markdown content>" --type <type> --title "<title>" [-d <domain-slug>] -f json
+```
+
+The content should be well-structured markdown explaining:
+- What changed and why (if discernible from commits/code)
+- Key files involved
+- Impact on the rest of the codebase
+
+### 5. Update Stale Nodes
+
+For modified files that have existing module nodes, check if the module documentation is stale:
+
+```bash
+ai search "<filename>" --types module -f json
+```
+
+If a module node exists and the file has changed significantly, update it:
+
+```bash
+ai update <node-id> --content "<updated content>"
+```
+
+### 6. Report Results
+
+Summarize:
+- Number of new nodes created (with IDs and titles)
+- Number of existing nodes updated
+- Changes that were skipped and why (already documented, too minor, etc.)
+
+## Guidelines
+
+- Be conservative — create fewer, higher-quality nodes rather than many low-value ones.
+- Each node should stand alone as useful documentation.
+- Use specific, searchable titles (not "Updated API" but "Add rate limiting middleware to API endpoints").
+- Prefer `decision` type when the change reflects a choice between alternatives.
+- Prefer `architecture` type for structural/design documentation.
+- Prefer `process` type for workflow/deployment/operational documentation.

package/skills/sync/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: sync
+description: Incrementally update the knowledge graph from git changes (faster than full ai map)
+disable-model-invocation: true
+context: fork
+allowed-tools: Bash, Read
+---
+
+# /sync — Incremental Knowledge Graph Sync
+
+Update the knowledge graph based on git changes since the last sync. Faster than a full `ai map` for ongoing development.
+
+## Input
+
+`$ARGUMENTS` is optional:
+- If a **commit range** is provided (e.g., `/sync abc123..HEAD`), use that range.
+- If empty, determine the range from the sync-marker node.
+
+## Steps
+
+### 1. Find Last Sync Point
+
+```bash
+ai search "sync-marker" --types sync-marker -f json
+```
+
+- If a sync-marker node exists, extract the `commitSha` from its metadata — this is the base commit.
+- If no sync-marker exists, this is the first sync. Use the base of the current branch or fall back to `HEAD~10`.
+- If `$ARGUMENTS` provides a commit range, use that instead.
+
+### 2. Get Changed Files
+
+```bash
+git diff <base>..HEAD --name-status
+```
+
+Categorize files:
+- **A** (Added) — new files to create module nodes for
+- **M** (Modified) — existing files to update module nodes for
+- **D** (Deleted) — files to archive module nodes for
+
+### 3. Filter Files
+
+Only process source files. Skip:
+- Lock files (`pnpm-lock.yaml`, `package-lock.json`, `yarn.lock`)
+- Config files (`.eslintrc`, `tsconfig.json`, `.prettierrc`, etc.)
+- Test files (`**/*.test.*`, `**/*.spec.*`, `**/__tests__/**`)
+- Generated files (`dist/`, `build/`, `.next/`, `node_modules/`)
+- Markdown files, dotfiles, images, and other non-source assets
+
+Include: `*.ts`, `*.tsx`, `*.js`, `*.jsx`, `*.py`, `*.go`, `*.rs`, `*.java` and similar source files.
+
+### 4. Check Scale
+
+If more than 30 source files changed, fall back to `ai map` for the affected directories instead of updating one-by-one:
+
+```bash
+ai map <directory> [--domain <slug>]
+```
+
+Then skip to step 8.
+
+### 5. Handle Added Files
+
+For each added source file:
+
+1. Read the file to understand its purpose.
+2. Create a module node:
+   ```bash
+   ai add "<module documentation>" --type module --title "<project>/<relative-path>" --status approved -f json
+   ```
+
+### 6. Handle Modified Files
+
+For each modified source file:
+
+1. Search for the existing module node:
+   ```bash
+   ai search "<project>/<relative-path>" --types module -f json
+   ```
+2. If found, read the current file and update the node:
+   ```bash
+   ai update <node-id> --content "<updated documentation>"
+   ```
+3. If not found, treat it like an added file (create a new module node).
+
+### 7. Handle Deleted Files
+
+For each deleted source file:
+
+1. Search for the existing module node:
+   ```bash
+   ai search "<project>/<relative-path>" --types module -f json
+   ```
+2. If found, archive it:
+   ```bash
+   ai status <node-id> archived
+   ```
+
+### 8. Update Sync Marker
+
+Determine the current HEAD SHA:
+
+```bash
+git rev-parse HEAD
+```
+
+If a sync-marker node already exists, update it:
+
+```bash
+ai update <marker-id> --content "Last synced at $(date -u +%Y-%m-%dT%H:%M:%SZ)" -m '{"commitSha":"<HEAD-SHA>","syncedAt":"<timestamp>"}'
+```
+
+If no sync-marker exists, create one:
+
+```bash
+ai add "Last synced at $(date -u +%Y-%m-%dT%H:%M:%SZ)" --type sync-marker --title "sync-marker" --status approved -m '{"commitSha":"<HEAD-SHA>","syncedAt":"<timestamp>"}' -f json
+```
+
+### 9. Report Results
+
+Summarize:
+- Files processed: added / modified / deleted
+- Nodes created / updated / archived
+- Current sync point (commit SHA)
+- Any errors or skipped files
+
+## Notes
+
+- The `--status approved` flag is used for sync-marker nodes so they don't clutter the draft queue.
+- Module nodes created by sync use the default `draft` status so they can be reviewed.
+- The project name for titles should match what `ai map` uses (typically the repo or directory name).