facult 2.3.1 → 2.5.0

package/src/paths.ts

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
@@ -93,6 +94,34 @@ export function preferredGlobalFacultStateDir(
   return join(preferredGlobalAiRoot(home), ".facult");
 }
 
+export function facultLocalStateRoot(home: string = defaultHomeDir()): string {
+  const override = process.env.FACULT_LOCAL_STATE_DIR?.trim();
+  if (override) {
+    return resolvePath(override, home);
+  }
+  if (process.platform === "darwin") {
+    return join(home, "Library", "Application Support", "fclt");
+  }
+  const xdg = process.env.XDG_STATE_HOME?.trim();
+  return xdg
+    ? join(resolvePath(xdg, home), "fclt")
+    : join(home, ".local", "state", "fclt");
+}
+
+export function facultLocalCacheRoot(home: string = defaultHomeDir()): string {
+  const override = process.env.FACULT_CACHE_DIR?.trim();
+  if (override) {
+    return resolvePath(override, home);
+  }
+  if (process.platform === "darwin") {
+    return join(home, "Library", "Caches", "fclt");
+  }
+  const xdg = process.env.XDG_CACHE_HOME?.trim();
+  return xdg
+    ? join(resolvePath(xdg, home), "fclt")
+    : join(home, ".cache", "fclt");
+}
+
 export function legacyExternalFacultStateDir(
   home: string = defaultHomeDir()
 ): string {
@@ -186,6 +215,46 @@ export function facultStateDir(
   return join(resolvedRoot, ".facult");
 }
 
+function machineStateProjectKey(
+  rootDir: string,
+  home: string = defaultHomeDir()
+): string {
+  const projectRoot = projectRootFromAiRoot(rootDir, home);
+  const labelSource = projectRoot ?? rootDir;
+  const label = basename(labelSource).trim().toLowerCase();
+  const slug = label.replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const digest = createHash("sha256")
+    .update(resolve(rootDir))
+    .digest("hex")
+    .slice(0, 12);
+  return `${slug || "project"}-${digest}`;
+}
+
+export function facultMachineStateDir(
+  home: string = defaultHomeDir(),
+  rootDir?: string
+): string {
+  const resolvedRoot = rootDir ?? facultRootDir(home);
+  const projectRoot = projectRootFromAiRoot(resolvedRoot, home);
+  return projectRoot
+    ? join(
+        facultLocalStateRoot(home),
+        "projects",
+        machineStateProjectKey(resolvedRoot, home)
+      )
+    : join(facultLocalStateRoot(home), "global");
+}
+
+export function facultInstallStatePath(
+  home: string = defaultHomeDir()
+): string {
+  return join(facultLocalStateRoot(home), "install.json");
+}
+
+export function facultRuntimeCacheDir(home: string = defaultHomeDir()): string {
+  return join(facultLocalCacheRoot(home), "runtime");
+}
+
 export function projectRootFromAiRoot(
   rootDir: string,
   home: string = defaultHomeDir()

package/src/scan.ts

@@ -601,6 +601,19 @@ function defaultSourceSpecs(
         "~/.codex/mcp.json",
       ],
     },
+    {
+      id: "factory",
+      name: "Factory",
+      candidates: ["~/.factory", "~/.factory/mcp.json"],
+      skillDirs: ["~/.factory/skills"],
+      configFiles: ["~/.factory/mcp.json"],
+      assets: [
+        {
+          kind: "agents-instructions",
+          patterns: ["~/.factory/AGENTS.md"],
+        },
+      ],
+    },
     {
       id: "claude",
       name: "Claude (CLI)",
@@ -784,6 +797,13 @@ function defaultSourceSpecs(
         },
       ],
     },
+    {
+      id: "factory-project",
+      name: "Factory (project)",
+      candidates: [join(cwd, ".factory")],
+      skillDirs: [join(cwd, ".factory", "skills")],
+      configFiles: [join(cwd, ".factory", "mcp.json")],
+    },
   ];
 
   if (includeGitHooks) {
@@ -1288,7 +1308,12 @@ async function buildFromRootResult(args: {
         }
         continue;
       }
-      if (name === ".codex" || name === ".agents" || name === ".clawdbot") {
+      if (
+        name === ".codex" ||
+        name === ".agents" ||
+        name === ".clawdbot" ||
+        name === ".factory"
+      ) {
         await scanToolDotDir(child);
         continue;
       }

package/src/self-update.ts

@@ -2,6 +2,7 @@ import { mkdir, rename } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import {
+  facultInstallStatePath,
   legacyExternalFacultStateDir,
   preferredGlobalFacultStateDir,
 } from "./paths";
@@ -88,6 +89,7 @@ export function parseSelfUpdateArgs(argv: string[]): ParsedArgs {
 
 async function loadInstallState(home: string): Promise<InstallState | null> {
   const paths = [
+    facultInstallStatePath(home),
     join(preferredGlobalFacultStateDir(home), "install.json"),
     join(legacyExternalFacultStateDir(home), "install.json"),
   ];
@@ -208,7 +210,7 @@ async function writeInstallState(args: {
   packageVersion?: string;
   binaryPath?: string;
 }) {
-  const dir = preferredGlobalFacultStateDir(args.home);
+  const dir = dirname(facultInstallStatePath(args.home));
   await mkdir(dir, { recursive: true });
   const payload: InstallState = {
     version: 1,
@@ -219,7 +221,7 @@ async function writeInstallState(args: {
     installedAt: new Date().toISOString(),
   };
   await Bun.write(
-    join(dir, "install.json"),
+    facultInstallStatePath(args.home),
     `${JSON.stringify(payload, null, 2)}\n`
   );
 }