azcodr 2.0.0 → 2.1.0

package/lib/guards.js

@@ -1,71 +1,69 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-const { ScaffoldError, ERROR_CODES } = require('./errors.js');
-
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import process from 'node:process';
+import { ScaffoldError, ERROR_CODES } from './errors.js';
+import { getTemplateDir } from './scaffold.js';
 /**
  * Filesystem scope guard (Supply Chain: filesystem access).
  * Constrains all reads/writes to targetDir / templateDir.
  */
-function assertInside(root, candidate, message) {
-  const resolvedRoot = path.resolve(root);
-  const resolvedCandidate = path.resolve(root, candidate);
-  const relative = path.relative(resolvedRoot, resolvedCandidate);
-  if (relative.startsWith('..') || path.isAbsolute(relative)) {
-    throw new ScaffoldError('E_PATH_ESCAPE', message || `${ERROR_CODES.E_PATH_ESCAPE}: ${candidate}`);
-  }
+export function assertInside(root, candidate, message) {
+    const resolvedRoot = path.resolve(root);
+    const resolvedCandidate = path.resolve(root, candidate);
+    const relative = path.relative(resolvedRoot, resolvedCandidate);
+    if (relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new ScaffoldError('E_PATH_ESCAPE', message || `${ERROR_CODES.E_PATH_ESCAPE}: ${candidate}`);
+    }
 }
-
 /**
  * Normalizes a path for protected-target comparison. On Windows the filesystem
  * is case-insensitive, so `C:\Users\Name` and `c:\users\name` are the same
  * directory and must compare equal.
  */
-function normalizeForComparison(p) {
-  const resolved = path.resolve(p);
-  return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+export function normalizeForComparison(p) {
+    const resolved = path.resolve(p);
+    return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
 }
-
 function readHomeDir() {
-  try {
-    return os.homedir();
-  } catch {
-    return '';
-  }
+    try {
+        return os.homedir();
+    }
+    catch {
+        return '';
+    }
 }
-
 function isFilesystemRoot(resolvedTarget) {
-  return resolvedTarget === path.parse(resolvedTarget).root;
+    return resolvedTarget === path.parse(resolvedTarget).root;
 }
-
 function isHomeOrParent(normalizedTarget, home) {
-  if (!home) return false;
-  if (normalizedTarget === normalizeForComparison(home)) return true;
-  const parent = path.dirname(path.resolve(home));
-  return normalizedTarget === normalizeForComparison(parent);
+    if (!home)
+        return false;
+    if (normalizedTarget === normalizeForComparison(home))
+        return true;
+    const parent = path.dirname(path.resolve(home));
+    return normalizedTarget === normalizeForComparison(parent);
 }
-
 function isTemplateAncestor(resolvedTarget, templateDir) {
-  const resolvedTemplate = path.resolve(templateDir);
-  const relative = path.relative(resolvedTarget, resolvedTemplate);
-  return relative !== '' && !relative.startsWith('..') && !path.isAbsolute(relative);
+    const resolvedTemplate = path.resolve(templateDir);
+    const relative = path.relative(resolvedTarget, resolvedTemplate);
+    return relative !== '' && !relative.startsWith('..') && !path.isAbsolute(relative);
 }
-
 function resolvesToProtectedLocation(resolvedTarget, home) {
-  // Symlink alias: a symlink to / or ~ must not bypass the lexical checks.
-  let real = null;
-  try {
-    if (!fs.existsSync(resolvedTarget)) return false;
-    real = fs.realpathSync(resolvedTarget);
-  } catch {
-    return false;
-  }
-  if (real === path.parse(real).root) return true;
-  return Boolean(home) && normalizeForComparison(real) === normalizeForComparison(home);
+    // Symlink alias: a symlink to / or ~ must not bypass the lexical checks.
+    let real = '';
+    try {
+        if (!fs.existsSync(resolvedTarget))
+            return false;
+        real = fs.realpathSync(resolvedTarget);
+    }
+    catch {
+        return false;
+    }
+    if (real === path.parse(real).root)
+        return true;
+    return Boolean(home) && normalizeForComparison(real) === normalizeForComparison(home);
 }
-
 /**
  * Returns true when `targetDir` is a location the scaffolder must never write
  * into: the filesystem root, the user's home directory, the home directory's
@@ -76,21 +74,22 @@ function resolvesToProtectedLocation(resolvedTarget, home) {
  * Lexical comparison is not enough: a symlink pointing at home must also be
  * caught, so an existing target is resolved with realpath before comparing.
  */
-function isProtectedTarget(targetDir, options = {}) {
-  const resolvedTarget = path.resolve(targetDir);
-  const normalizedTarget = normalizeForComparison(resolvedTarget);
-  if (isFilesystemRoot(resolvedTarget)) return true;
-  const home = readHomeDir();
-  if (isHomeOrParent(normalizedTarget, home)) return true;
-  // Deferred require: scaffold.js requires this module, so a top-level
-  // require would be circular. Resolved at call time, after both modules load.
-  const { templateDir = require('./scaffold.js').getTemplateDir() } = options;
-  if (isTemplateAncestor(resolvedTarget, templateDir)) return true;
-  return resolvesToProtectedLocation(resolvedTarget, home);
+export function isProtectedTarget(targetDir, options = {}) {
+    const resolvedTarget = path.resolve(targetDir);
+    const normalizedTarget = normalizeForComparison(resolvedTarget);
+    if (isFilesystemRoot(resolvedTarget))
+        return true;
+    const home = readHomeDir();
+    if (isHomeOrParent(normalizedTarget, home))
+        return true;
+    const { templateDir = getTemplateDir() } = options;
+    if (isTemplateAncestor(resolvedTarget, templateDir))
+        return true;
+    return resolvesToProtectedLocation(resolvedTarget, home);
 }
-
-module.exports = {
-  assertInside,
-  normalizeForComparison,
-  isProtectedTarget
+export default {
+    assertInside,
+    normalizeForComparison,
+    isProtectedTarget
 };
+//# sourceMappingURL=guards.js.map

package/lib/guards.js.map

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

package/lib/index.d.ts

@@ -1,199 +1,6 @@
-/**
- * Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template
- * Programmatic API Definitions
- */
-
-export interface ScaffoldOptions {
-  /** Target directory path where template should be scaffolded (default: process.cwd()) */
-  targetDir?: string;
-  /** Force overwrite if target directory is non-empty (default: false) */
-  force?: boolean;
-  /** Skip git repository initialization (default: false) */
-  noGit?: boolean;
-  /** Custom template root directory (default: azcodr root) */
-  templateDir?: string;
-  /** Simulate scaffolding without writing files or running git (default: false) */
-  dryRun?: boolean;
-  /** Suppress console output messages (default: false) */
-  silent?: boolean;
-}
-
-export interface ScaffoldResult {
-  /** Whether the scaffolding succeeded */
-  success: boolean;
-  /** Absolute resolved path of the target directory */
-  targetDir: string;
-  /** Whether git init was successfully executed */
-  gitInitialized: boolean;
-  /** Whether execution ran in dry-run simulation mode */
-  dryRun: boolean;
-  /** List of files, directories, and symlinks created or simulated */
-  actions: string[];
-}
-
-export interface ValidateTargetOptions {
-  /** Custom template root directory */
-  templateDir?: string;
-  /** Force allow non-empty directory */
-  force?: boolean;
-  /**
-   * Bypass the protected-target guard (filesystem root, home, home's parent,
-   * template ancestors). The CLI never passes this. Programmatic use only.
-   */
-  allowProtected?: boolean;
-}
-
-export interface InitGitOptions {
-  /** If true, skips git initialization */
-  noGit?: boolean;
-  /** If true, simulates git initialization without executing */
-  dryRun?: boolean;
-}
-
-export interface CopyTemplateOptions {
-  /** If true, simulates copy without writing to disk */
-  dryRun?: boolean;
-}
-
-/**
- * Machine-readable failure codes thrown by this library.
- *
- * Branch on `error.code`, never on `error.message`: message wording may change
- * between releases, codes are part of the public contract.
- */
-export type ScaffoldErrorCode =
-  | 'E_TARGET_IS_TEMPLATE'
-  | 'E_TARGET_NOT_EMPTY'
-  | 'E_TARGET_IS_PROTECTED'
-  | 'E_GIT_ARGS_INVALID'
-  | 'E_GIT_BLOCKED'
-  | 'E_PATH_ESCAPE';
-
-/** Error type thrown by every azcodr API. Always carries a `code`. */
-export interface ScaffoldErrorShape extends Error {
-  name: 'ScaffoldError';
-  code: ScaffoldErrorCode;
-}
-
-export declare class ScaffoldError extends Error implements ScaffoldErrorShape {
-  constructor(code: ScaffoldErrorCode, message: string);
-  name: 'ScaffoldError';
-  code: ScaffoldErrorCode;
-}
-
-/** Human-readable prefix for each code, as thrown. */
-export declare const ERROR_CODES: Readonly<Record<ScaffoldErrorCode, string>>;
-
-/**
- * High-level orchestration function to scaffold the azcodr workspace into targetDir.
- */
-export function scaffold(options?: ScaffoldOptions): ScaffoldResult;
-
-/**
- * Validates the target directory to ensure it is suitable for scaffolding.
- */
-export function validateTarget(targetDir: string, options?: ValidateTargetOptions): void;
-
-/**
- * Copies template items into target directory and sets up symlinks and permissions.
- */
-export function copyTemplate(
-  targetDir: string,
-  templateDir?: string,
-  options?: CopyTemplateOptions
-): string[];
-
-/**
- * Safely creates or updates a symbolic link, falling back to a file copy if symlinks are unsupported.
- */
-export function ensureSymlink(options: {
-  targetDir: string;
-  linkName: string;
-  targetFileName: string;
-  dryRun?: boolean;
-}): boolean;
-
-/**
- * Creates a symlink, falling back to a text pointer (not a full copy).
- */
-export function ensureSymlinkOrPointer(options: {
-  targetDir: string;
-  linkName: string;
-  targetFileName: string;
-  dryRun?: boolean;
-}): boolean;
-
-/**
- * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
- */
-export function isSameCaseInsensitiveFile(
-  targetDir: string,
-  linkName: string,
-  targetFileName: string
-): boolean;
-
-/**
- * Ensures all bash scripts in skill directories have executable permissions (0o755).
- */
-export function makeScriptsExecutable(targetDir: string, dryRun?: boolean): string[];
-
-/**
- * Initializes a git repository in the target directory if not already inside one.
- */
-export function initGit(targetDir: string, options?: InitGitOptions): boolean;
-
-/**
- * Detects whether targetDir is already inside an existing Git worktree.
- * Shell access is limited to `git rev-parse` via a shell-free allowlisted spawn.
- */
-export function isInsideGitWorkTree(targetDir: string): boolean;
-
-/**
- * Spawns `git` with argv (never a shell string) through an explicit
- * subcommand allowlist. @throws ScaffoldError with E_GIT_ARGS_INVALID or E_GIT_BLOCKED.
- */
-export function runGit(args: string[], options?: Record<string, unknown>): string;
-
-/**
- * Scope guard: throws if `candidate` resolves outside `root`.
- * @throws ScaffoldError with E_PATH_ESCAPE.
- */
-export function assertInside(root: string, candidate: string, message?: string): void;
-
-/**
- * Returns true when `targetDir` is a protected system location the scaffolder
- * must never write into (filesystem root, home, home's parent, template
- * ancestors, symlink aliases). @throws never; pure predicate.
- */
-export function isProtectedTarget(targetDir: string, options?: ValidateTargetOptions): boolean;
-
-/**
- * Returns the root path to the azcodr template files.
- */
-export function getTemplateDir(): string;
-
-/**
- * Array of essential template files and directories copied during scaffolding.
- */
-export const TEMPLATE_ITEMS: readonly string[];
-
-declare const defaultExport: {
-  scaffold: typeof scaffold;
-  validateTarget: typeof validateTarget;
-  copyTemplate: typeof copyTemplate;
-  ensureSymlink: typeof ensureSymlink;
-  ensureSymlinkOrPointer: typeof ensureSymlinkOrPointer;
-  isSameCaseInsensitiveFile: typeof isSameCaseInsensitiveFile;
-  makeScriptsExecutable: typeof makeScriptsExecutable;
-  initGit: typeof initGit;
-  isInsideGitWorkTree: typeof isInsideGitWorkTree;
-  runGit: typeof runGit;
-  assertInside: typeof assertInside;
-  isProtectedTarget: typeof isProtectedTarget;
-  getTemplateDir: typeof getTemplateDir;
-  TEMPLATE_ITEMS: typeof TEMPLATE_ITEMS;
-  ScaffoldError: typeof ScaffoldError;
-  ERROR_CODES: typeof ERROR_CODES;
-};
-
-export default defaultExport;
+export type ScaffoldErrorCode = 'E_TARGET_IS_TEMPLATE' | 'E_TARGET_NOT_EMPTY' | 'E_TARGET_IS_PROTECTED' | 'E_GIT_ARGS_INVALID' | 'E_GIT_BLOCKED' | 'E_PATH_ESCAPE';
+export { scaffold, validateTarget, copyTemplate, ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable, initGit, isInsideGitWorkTree, runGit, assertInside, isProtectedTarget, getTemplateDir, TEMPLATE_ITEMS, ScaffoldError, ERROR_CODES } from './scaffold.js';
+export type { ScaffoldOptions, ScaffoldResult, ValidateTargetOptions, CopyTemplateOptions, EnsureSymlinkOptions, InitGitOptions, ScaffoldErrorShape } from './scaffold.js';
+import scaffoldModule from './scaffold.js';
+export default scaffoldModule;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,oBAAoB,GACpB,eAAe,GACf,eAAe,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,OAAO,EACP,mBAAmB,EACnB,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,cAAc,MAAM,eAAe,CAAC;AAC3C,eAAe,cAAc,CAAC"}

package/lib/index.js

@@ -1,5 +1,4 @@
-'use strict';
-
-const scaffold = require('./scaffold.js');
-
-module.exports = scaffold;
+export { scaffold, validateTarget, copyTemplate, ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable, initGit, isInsideGitWorkTree, runGit, assertInside, isProtectedTarget, getTemplateDir, TEMPLATE_ITEMS, ScaffoldError, ERROR_CODES } from './scaffold.js';
+import scaffoldModule from './scaffold.js';
+export default scaffoldModule;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,OAAO,EACP,mBAAmB,EACnB,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACZ,MAAM,eAAe,CAAC;AAYvB,OAAO,cAAc,MAAM,eAAe,CAAC;AAC3C,eAAe,cAAc,CAAC"}

package/lib/links.d.ts

@@ -0,0 +1,28 @@
+export interface EnsureSymlinkOptions {
+    targetDir: string;
+    linkName: string;
+    targetFileName: string;
+    dryRun?: boolean;
+}
+/**
+ * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
+ * Uses exact directory listing (not existsSync, which lies on case-insensitive systems).
+ */
+export declare function isSameCaseInsensitiveFile(targetDir: string, linkName: string, targetFileName: string): boolean;
+/**
+ * Safely creates or updates a symbolic link, falling back to a file copy if symlinks are unsupported.
+ */
+export declare function ensureSymlink(options: EnsureSymlinkOptions): boolean;
+/**
+ * Creates a symlink, falling back to a text pointer (not a full copy).
+ * Used for .github/copilot-instructions.md where a full AGENTS.md copy would
+ * break relative markdown links (they resolve from .github/, not root).
+ */
+export declare function ensureSymlinkOrPointer(options: EnsureSymlinkOptions): boolean;
+declare const _default: {
+    isSameCaseInsensitiveFile: typeof isSameCaseInsensitiveFile;
+    ensureSymlink: typeof ensureSymlink;
+    ensureSymlinkOrPointer: typeof ensureSymlinkOrPointer;
+};
+export default _default;
+//# sourceMappingURL=links.d.ts.map

package/lib/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA6DD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAapE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAmB7E;;;;;;AAED,wBAIE"}

package/lib/links.js

@@ -1,123 +1,129 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-/**
- * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
- * Uses exact directory listing (not existsSync, which lies on case-insensitive systems).
- */
+import fs from 'node:fs';
+import path from 'node:path';
 function namesDifferOnlyByCase(linkName, targetFileName) {
-  if (linkName.toLowerCase() !== targetFileName.toLowerCase()) return false;
-  return linkName !== targetFileName;
+    if (linkName.toLowerCase() !== targetFileName.toLowerCase())
+        return false;
+    return linkName !== targetFileName;
 }
-
 function readDirEntries(targetDir) {
-  try {
-    return fs.readdirSync(targetDir);
-  } catch {
-    return null;
-  }
+    try {
+        return fs.readdirSync(targetDir);
+    }
+    catch {
+        return null;
+    }
 }
-
-function bothEntriesExist({ targetDir, linkName, targetFileName, entries }) {
-  if (!entries.includes(targetFileName) || !entries.includes(linkName)) return false;
-  try {
-    fs.lstatSync(path.join(targetDir, targetFileName));
-    fs.lstatSync(path.join(targetDir, linkName));
-    return true;
-  } catch {
-    return false;
-  }
+function bothEntriesExist(options) {
+    const { targetDir, linkName, targetFileName, entries } = options;
+    if (!entries.includes(targetFileName) || !entries.includes(linkName))
+        return false;
+    try {
+        fs.lstatSync(path.join(targetDir, targetFileName));
+        fs.lstatSync(path.join(targetDir, linkName));
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
-
 function accessiblePair(targetPath, linkPath) {
-  // Case-insensitive collision: the listing holds one spelling while both
-  // paths resolve. Verify the entries are accessible (throws on disk error).
-  if (!fs.existsSync(targetPath) || !fs.existsSync(linkPath)) return false;
-  try {
-    fs.lstatSync(targetPath);
-    fs.lstatSync(linkPath);
-  } catch {
-    return false;
-  }
-  return true;
-}
-
-function isSameCaseInsensitiveFile(targetDir, linkName, targetFileName) {
-  if (linkName === targetFileName) return true;
-  if (!namesDifferOnlyByCase(linkName, targetFileName)) return false;
-  const entries = readDirEntries(targetDir);
-  if (entries === null) return false;
-  if (bothEntriesExist({ targetDir, linkName, targetFileName, entries })) {
-    return !fs.lstatSync(path.join(targetDir, linkName)).isSymbolicLink();
-  }
-  const targetPath = path.join(targetDir, targetFileName);
-  const linkPath = path.join(targetDir, linkName);
-  return accessiblePair(targetPath, linkPath);
+    if (!fs.existsSync(targetPath) || !fs.existsSync(linkPath))
+        return false;
+    try {
+        fs.lstatSync(targetPath);
+        fs.lstatSync(linkPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
-
 function removeIfExists(linkPath) {
-  try {
-    fs.lstatSync(linkPath);
-    fs.rmSync(linkPath, { force: true });
-  } catch {
-    // Path does not exist, proceed
-  }
+    try {
+        fs.lstatSync(linkPath);
+        fs.rmSync(linkPath, { force: true });
+    }
+    catch {
+        // Path does not exist, proceed
+    }
 }
-
 function copyFallback(targetDir, linkName, targetFileName) {
-  // Fallback if environment (e.g., certain Windows configs) prevents symlink creation
-  const sourceFile = path.resolve(targetDir, targetFileName);
-  if (fs.existsSync(sourceFile)) {
-    fs.copyFileSync(sourceFile, path.join(targetDir, linkName));
-  }
+    const sourceFile = path.resolve(targetDir, targetFileName);
+    if (fs.existsSync(sourceFile)) {
+        fs.copyFileSync(sourceFile, path.join(targetDir, linkName));
+    }
+}
+/**
+ * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
+ * Uses exact directory listing (not existsSync, which lies on case-insensitive systems).
+ */
+export function isSameCaseInsensitiveFile(targetDir, linkName, targetFileName) {
+    if (linkName === targetFileName)
+        return true;
+    if (!namesDifferOnlyByCase(linkName, targetFileName))
+        return false;
+    const entries = readDirEntries(targetDir);
+    if (entries === null)
+        return false;
+    if (bothEntriesExist({ targetDir, linkName, targetFileName, entries })) {
+        return !fs.lstatSync(path.join(targetDir, linkName)).isSymbolicLink();
+    }
+    const targetPath = path.join(targetDir, targetFileName);
+    const linkPath = path.join(targetDir, linkName);
+    return accessiblePair(targetPath, linkPath);
 }
-
 /**
  * Safely creates or updates a symbolic link, falling back to a file copy if symlinks are unsupported.
  */
-function ensureSymlink({ targetDir, linkName, targetFileName, dryRun = false }) {
-  if (dryRun) return true;
-  if (isSameCaseInsensitiveFile(targetDir, linkName, targetFileName)) return true;
-  const linkPath = path.join(targetDir, linkName);
-  removeIfExists(linkPath);
-  try {
-    fs.symlinkSync(targetFileName, linkPath, 'file');
-    return true;
-  } catch {
-    copyFallback(targetDir, linkName, targetFileName);
-    return true;
-  }
+export function ensureSymlink(options) {
+    const { targetDir, linkName, targetFileName, dryRun = false } = options;
+    if (dryRun)
+        return true;
+    if (isSameCaseInsensitiveFile(targetDir, linkName, targetFileName))
+        return true;
+    const linkPath = path.join(targetDir, linkName);
+    removeIfExists(linkPath);
+    try {
+        fs.symlinkSync(targetFileName, linkPath, 'file');
+        return true;
+    }
+    catch {
+        copyFallback(targetDir, linkName, targetFileName);
+        return true;
+    }
 }
-
 /**
  * Creates a symlink, falling back to a text pointer (not a full copy).
  * Used for .github/copilot-instructions.md where a full AGENTS.md copy would
  * break relative markdown links (they resolve from .github/, not root).
  */
-function ensureSymlinkOrPointer({ targetDir, linkName, targetFileName, dryRun = false }) {
-  if (dryRun) return true;
-  const linkPath = path.join(targetDir, linkName);
-  try {
+export function ensureSymlinkOrPointer(options) {
+    const { targetDir, linkName, targetFileName, dryRun = false } = options;
+    if (dryRun)
+        return true;
+    const linkPath = path.join(targetDir, linkName);
     try {
-      fs.lstatSync(linkPath);
-      const existing = fs.existsSync(linkPath) ? fs.readFileSync(linkPath, 'utf-8') : '';
-      if (existing.trim() === targetFileName) return true;
-      fs.rmSync(linkPath, { force: true });
-    } catch {
-      // Path does not exist, proceed
+        try {
+            fs.lstatSync(linkPath);
+            const existing = fs.existsSync(linkPath) ? fs.readFileSync(linkPath, 'utf-8') : '';
+            if (existing.trim() === targetFileName)
+                return true;
+            fs.rmSync(linkPath, { force: true });
+        }
+        catch {
+            // Path does not exist, proceed
+        }
+        fs.symlinkSync(targetFileName, linkPath, 'file');
+        return true;
+    }
+    catch {
+        fs.writeFileSync(linkPath, `${targetFileName}\n`, 'utf-8');
+        return true;
     }
-    fs.symlinkSync(targetFileName, linkPath, 'file');
-    return true;
-  } catch {
-    fs.writeFileSync(linkPath, `${targetFileName}\n`, 'utf-8');
-    return true;
-  }
 }
-
-module.exports = {
-  isSameCaseInsensitiveFile,
-  ensureSymlink,
-  ensureSymlinkOrPointer
+export default {
+    isSameCaseInsensitiveFile,
+    ensureSymlink,
+    ensureSymlinkOrPointer
 };
+//# sourceMappingURL=links.js.map

package/lib/links.js.map

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