facult 1.3.0 → 2.1.0

package/src/scan.ts

@@ -512,7 +512,7 @@ function defaultSourceSpecs(
   const specs: SourceSpec[] = [
     {
       id: "facult",
-      name: "facult (canonical)",
+      name: "fclt (canonical)",
       candidates: [canonicalRoot],
       skillDirs: [join(canonicalRoot, "skills")],
       configFiles: [
@@ -1677,7 +1677,7 @@ function printSourceAssets(assets: SourceResult["assets"]) {
 }
 
 function printHuman(res: ScanResult) {
-  console.log(`facult scan — ${res.scannedAt}`);
+  console.log(`fclt scan — ${res.scannedAt}`);
   console.log("");
 
   const foundSources = res.sources.filter((s) => s.found);
@@ -1976,7 +1976,7 @@ async function computeAssetContentDuplicates(
 function _printSkillsTable(res: ScanResult) {
   const all = computeSkillOccurrences(res);
 
-  console.log(`facult scan — ${res.scannedAt}`);
+  console.log(`fclt scan — ${res.scannedAt}`);
   console.log("Skills (deduplicated by SKILL.md parent directory name):");
 
   if (all.length === 0) {
@@ -2009,7 +2009,7 @@ function _printSkillsTable(res: ScanResult) {
 function printSkillDuplicatesTable(res: ScanResult) {
   const all = computeSkillOccurrences(res).filter((d) => d.count > 1);
 
-  console.log(`facult scan — ${res.scannedAt}`);
+  console.log(`fclt scan — ${res.scannedAt}`);
   console.log("Duplicate skills (same skill name appears in multiple places):");
 
   if (all.length === 0) {
@@ -2232,14 +2232,14 @@ export async function writeState(res: ScanResult) {
 }
 
 function printScanHelp() {
-  console.log(`facult scan — inventory local agent configs across tools
+  console.log(`fclt scan — inventory local agent configs across tools
 
 Usage:
-  facult scan [--json] [--show-duplicates] [--tui]
-  facult scan --from <path> [--from <path> ...]
+  fclt scan [--json] [--show-duplicates] [--tui]
+  fclt scan --from <path> [--from <path> ...]
 
 Notes:
-  - If no --from roots are provided and no scanFrom is configured, facult defaults to scanning ~.
+  - If no --from roots are provided and no scanFrom is configured, fclt defaults to scanning ~.
 
 Options:
   --json              Print full JSON (ScanResult)

package/src/schema.ts

@@ -3,7 +3,7 @@ export interface Provenance {
   sourceId: string;
   /** Path to the config file this item came from (if applicable). */
   sourcePath: string;
-  /** ISO timestamp when facult imported/consolidated this item. */
+  /** ISO timestamp when fclt imported/consolidated this item. */
   importedAt: string;
   /** Optional source file mtime at import time (ISO). */
   sourceModifiedAt?: string;

package/src/self-update.ts

@@ -8,8 +8,10 @@ import {
 
 const REPO_OWNER = "hack-dance";
 const REPO_NAME = "facult";
+const PACKAGE_NAME = "facult";
 const DOWNLOAD_RETRIES = 12;
 const DOWNLOAD_RETRY_DELAY_MS = 5000;
+const CLI_BASENAME_PATTERN = /^(fclt|facult)(\.exe)?$/;
 
 type InstallMethod =
   | "script-dev"
@@ -40,11 +42,11 @@ interface DetectInstallMethodContext {
 }
 
 function printHelp() {
-  console.log(`facult self-update — update facult itself based on install method
+  console.log(`fclt self-update — update fclt itself based on install method
 
 Usage:
-  facult self-update [--version <x.y.z|latest>] [--dry-run]
-  facult update --self [--version <x.y.z|latest>] [--dry-run]
+  fclt self-update [--version <x.y.z|latest>] [--dry-run]
+  fclt update --self [--version <x.y.z|latest>] [--dry-run]
 
 Options:
   --version   Target version (defaults to latest)
@@ -131,7 +133,8 @@ export function detectInstallMethod(
   if (
     facultBins.some(
       (facultBin) =>
-        exec.startsWith(facultBin + sep) && basename(exec).startsWith("facult")
+        exec.startsWith(facultBin + sep) &&
+        CLI_BASENAME_PATTERN.test(basename(exec))
     )
   ) {
     return "release-script";
@@ -173,7 +176,7 @@ async function resolveLatestTag(): Promise<string> {
   const url = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest`;
   const res = await fetch(url, {
     headers: {
-      "user-agent": "facult-self-update",
+      "user-agent": "fclt-self-update",
       accept: "application/vnd.github+json",
     },
   });
@@ -232,11 +235,16 @@ async function selfUpdateBinary(args: {
   const explicitTag = normalizeVersionTag(args.requestedVersion);
   const tag = explicitTag ?? (await resolveLatestTag());
   const version = stripTagPrefix(tag);
-  const assetName = `facult-${version}-${target.platform}-${target.arch}${target.ext}`;
-  const url = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${assetName}`;
+  const assetNames = [
+    `${PACKAGE_NAME}-${version}-${target.platform}-${target.arch}${target.ext}`,
+    `facult-${version}-${target.platform}-${target.arch}${target.ext}`,
+  ];
+  const urls = assetNames.map(
+    (assetName) =>
+      `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${assetName}`
+  );
 
-  const defaultBinaryName =
-    target.platform === "windows" ? "facult.exe" : "facult";
+  const defaultBinaryName = target.platform === "windows" ? "fclt.exe" : "fclt";
   const fallbackPath = join(
     preferredGlobalFacultStateDir(args.home),
     "bin",
@@ -245,17 +253,19 @@ async function selfUpdateBinary(args: {
   const currentExec = process.execPath;
   const preferredPath =
     args.state?.binaryPath ||
-    (basename(currentExec).startsWith("facult") ? currentExec : fallbackPath);
+    (CLI_BASENAME_PATTERN.test(basename(currentExec))
+      ? currentExec
+      : fallbackPath);
   const binaryPath = resolve(preferredPath);
 
   if (args.dryRun) {
-    console.log(`[dry-run] Would download ${url}`);
+    console.log(`[dry-run] Would download ${urls[0]}`);
     console.log(`[dry-run] Would replace ${binaryPath}`);
     return;
   }
 
   await mkdir(dirname(binaryPath), { recursive: true });
-  const bytes = await fetchReleaseBinaryWithRetry(url);
+  const bytes = await fetchFirstReleaseBinaryWithRetry(urls);
   const tmpPath = `${binaryPath}.tmp-${Date.now()}`;
   await Bun.write(tmpPath, Buffer.from(bytes));
   if (target.platform !== "windows") {
@@ -268,7 +278,7 @@ async function selfUpdateBinary(args: {
     packageVersion: version,
     binaryPath,
   });
-  console.log(`Updated facult binary to ${version}`);
+  console.log(`Updated fclt binary to ${version}`);
   console.log(`Path: ${binaryPath}`);
 }
 
@@ -307,7 +317,7 @@ async function selfUpdateViaPackageManager(args: {
       ? stripTagPrefix(args.requestedVersion)
       : "latest";
 
-  const installSpec = `facult@${targetVersion}`;
+  const installSpec = `${PACKAGE_NAME}@${targetVersion}`;
   const cmd =
     pm === "npm"
       ? ["npm", "install", "-g", installSpec]
@@ -329,7 +339,7 @@ async function selfUpdateViaPackageManager(args: {
   if (code !== 0) {
     throw new Error(`Self-update failed via ${pm} (exit ${code}).`);
   }
-  console.log(`Updated facult via ${pm}: ${installSpec}`);
+  console.log(`Updated fclt via ${pm}: ${installSpec}`);
 }
 
 async function fetchReleaseBinaryWithRetry(url: string): Promise<ArrayBuffer> {
@@ -340,7 +350,7 @@ async function fetchReleaseBinaryWithRetry(url: string): Promise<ArrayBuffer> {
     try {
       const response = await fetch(url, {
         headers: {
-          "user-agent": "facult-self-update",
+          "user-agent": "fclt-self-update",
           accept: "application/octet-stream",
         },
       });
@@ -375,6 +385,20 @@ async function fetchReleaseBinaryWithRetry(url: string): Promise<ArrayBuffer> {
   throw new Error(`Failed to download ${url}.${statusDetail}`);
 }
 
+async function fetchFirstReleaseBinaryWithRetry(
+  urls: string[]
+): Promise<ArrayBuffer> {
+  let lastError: unknown;
+  for (const url of urls) {
+    try {
+      return await fetchReleaseBinaryWithRetry(url);
+    } catch (error) {
+      lastError = error;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error("Download failed.");
+}
+
 function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);

package/src/snippets-cli.ts

@@ -10,14 +10,14 @@ import {
 const EDITOR_SPLIT_RE = /\s+/;
 
 function printSnippetsHelp() {
-  console.log(`facult snippets — sync reusable blocks across config files
+  console.log(`fclt snippets — sync reusable blocks across config files
 
 Usage:
-  facult snippets list [--json]
-  facult snippets show <name> [--json]
-  facult snippets create <name>
-  facult snippets edit <name>
-  facult snippets sync [--dry-run] [file...]
+  fclt snippets list [--json]
+  fclt snippets show <name> [--json]
+  fclt snippets create <name>
+  fclt snippets edit <name>
+  fclt snippets sync [--dry-run] [file...]
 
 Notes:
   - <name> is the snippet marker name (e.g. codingstyle, global/codingstyle, myproject/context)

package/src/trust.ts

@@ -36,7 +36,7 @@ async function loadIndex(homeDir: string): Promise<FacultIndex> {
   });
   const file = Bun.file(indexPath);
   if (!(await file.exists())) {
-    throw new Error(`Index not found at ${indexPath}. Run "facult index".`);
+    throw new Error(`Index not found at ${indexPath}. Run "fclt index".`);
   }
   const raw = await file.text();
   return JSON.parse(raw) as FacultIndex;
@@ -130,11 +130,11 @@ function parseNamesFromArgv(argv: string[]): string[] {
 
 export async function trustCommand(argv: string[]) {
   if (argv.includes("--help") || argv.includes("-h") || argv[0] === "help") {
-    console.log(`facult trust — mark skills or MCP servers as trusted (annotation only)
+    console.log(`fclt trust — mark skills or MCP servers as trusted (annotation only)
 
 Usage:
-  facult trust <name> [moreNames...]
-  facult trust mcp:<name> [moreNames...]
+  fclt trust <name> [moreNames...]
+  fclt trust mcp:<name> [moreNames...]
 `);
     return;
   }
@@ -143,7 +143,7 @@ Usage:
     await applyTrust({ names, mode: "trust" });
     console.log(`Marked as trusted: ${names.join(", ")}`);
     console.log(
-      'Note: Trust is an annotation. Run "facult audit" for security review.'
+      'Note: Trust is an annotation. Run "fclt audit" for security review.'
     );
   } catch (err) {
     console.error(err instanceof Error ? err.message : String(err));
@@ -153,11 +153,11 @@ Usage:
 
 export async function untrustCommand(argv: string[]) {
   if (argv.includes("--help") || argv.includes("-h") || argv[0] === "help") {
-    console.log(`facult untrust — remove trusted annotation
+    console.log(`fclt untrust — remove trusted annotation
 
 Usage:
-  facult untrust <name> [moreNames...]
-  facult untrust mcp:<name> [moreNames...]
+  fclt untrust <name> [moreNames...]
+  fclt untrust mcp:<name> [moreNames...]
 `);
     return;
   }

package/src/tui.ts

@@ -29,7 +29,7 @@ export async function runSkillsTui(res: ScanResult): Promise<void> {
     height,
     borderStyle: "double",
     borderColor: "#4CC9F0",
-    title: "facult scan — skills",
+    title: "fclt scan — skills",
     titleAlignment: "center",
     backgroundColor: "#001122",
   });