azcodr 2.0.0 → 2.2.0

package/lib/guards.js

@@ -1,71 +1,77 @@
-'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.
+ * Constrains all reads/writes to targetDir / templateDir, throwing if candidate escapes root.
+ *
+ * @param root - Absolute base directory.
+ * @param candidate - Candidate file or directory path to check.
+ * @param message - Optional custom error message.
+ * @throws {ScaffoldError} When candidate path escapes root directory.
  */
-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.
+ *
+ * @param p - File or directory path to normalize.
+ * @returns Normalized path string.
  */
-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
@@ -75,22 +81,27 @@ 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.
+ *
+ * @param targetDir - The target directory path to evaluate.
+ * @param options - Optional configuration for protected target evaluation.
+ * @returns True if target is a protected location, false otherwise.
  */
-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,25 @@
 /**
- * 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.
+ * @module @azcodr/azcodr
+ * Enterprise Architecture & Agentic Engineering Starter Template.
  *
- * 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.
+ * Provides problem-first, topology-aligned project scaffolding with strict systemic atomicity,
+ * filesystem scope guards, git worktree initialization, and multi-agent harness parity.
  */
-export function runGit(args: string[], options?: Record<string, unknown>): string;
-
 /**
- * Scope guard: throws if `candidate` resolves outside `root`.
- * @throws ScaffoldError with E_PATH_ESCAPE.
+ * Union type of all valid machine-readable error codes.
  */
-export function assertInside(root: string, candidate: string, message?: string): void;
-
+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';
 /**
- * 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.
+ * Core scaffolding functions, guards, utilities, error classes, and constants.
  */
-export function isProtectedTarget(targetDir: string, options?: ValidateTargetOptions): boolean;
-
+export { scaffold, validateTarget, copyTemplate, ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable, initGit, isInsideGitWorkTree, runGit, assertInside, isProtectedTarget, getTemplateDir, TEMPLATE_ITEMS, ScaffoldError, ERROR_CODES } from './scaffold.js';
 /**
- * Returns the root path to the azcodr template files.
+ * Type definitions and option interfaces for scaffolding operations.
  */
-export function getTemplateDir(): string;
-
+export type { ScaffoldOptions, ScaffoldResult, ValidateTargetOptions, CopyTemplateOptions, EnsureSymlinkOptions, InitGitOptions, ScaffoldErrorShape } from './scaffold.js';
+import scaffoldModule from './scaffold.js';
 /**
- * Array of essential template files and directories copied during scaffolding.
+ * Default export providing the unified azcodr scaffolding module.
  */
-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 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;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,oBAAoB,GACpB,eAAe,GACf,eAAe,CAAC;AAEpB;;GAEG;AACH,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;;GAEG;AACH,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;AAE3C;;GAEG;AACH,eAAe,cAAc,CAAC"}

package/lib/index.js

@@ -1,5 +1,17 @@
-'use strict';
-
-const scaffold = require('./scaffold.js');
-
-module.exports = scaffold;
+/**
+ * @module @azcodr/azcodr
+ * Enterprise Architecture & Agentic Engineering Starter Template.
+ *
+ * Provides problem-first, topology-aligned project scaffolding with strict systemic atomicity,
+ * filesystem scope guards, git worktree initialization, and multi-agent harness parity.
+ */
+/**
+ * Core scaffolding functions, guards, utilities, error classes, and constants.
+ */
+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';
+/**
+ * Default export providing the unified azcodr scaffolding module.
+ */
+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":"AAAA;;;;;;GAMG;AAaH;;GAEG;AACH,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,OAAO,cAAc,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,eAAe,cAAc,CAAC"}

package/lib/links.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Configuration options for symlink and pointer creation.
+ */
+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).
+ *
+ * @param targetDir - Directory containing the file entries.
+ * @param linkName - Name of the proposed symlink or alias entry.
+ * @param targetFileName - Target file name to match against.
+ * @returns True if both names resolve to the same disk file on a case-insensitive filesystem.
+ */
+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.
+ *
+ * @param options - Options specifying target directory, link name, target file name, and dry-run mode.
+ * @returns True if the symlink or copy fallback was successfully established.
+ */
+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).
+ *
+ * @param options - Options specifying target directory, link name, target file name, and dry-run mode.
+ * @returns True if the symlink or pointer fallback was successfully established.
+ */
+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;;GAEG;AACH,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;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAWT;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAapE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAmB7E;;;;;;AAED,wBAIE"}