azcodr 2.0.0 → 2.2.0

package/lib/scaffold.d.ts

@@ -0,0 +1,109 @@
+import { ScaffoldError, ERROR_CODES } from './errors.js';
+import type { ScaffoldErrorCode, ScaffoldErrorShape } from './errors.js';
+import { runGit } from './git.js';
+import { assertInside, isProtectedTarget } from './guards.js';
+import { ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile } from './links.js';
+import type { EnsureSymlinkOptions } from './links.js';
+import { makeScriptsExecutable } from './permissions.js';
+import { isInsideGitWorkTree, initGit } from './repo.js';
+import type { InitGitOptions } from './repo.js';
+/**
+ * Canonical list of template files and directories copied into a new workspace.
+ */
+export declare const TEMPLATE_ITEMS: readonly string[];
+/**
+ * Configuration options for the primary scaffold orchestration function.
+ */
+export interface ScaffoldOptions {
+    targetDir?: string;
+    force?: boolean;
+    noGit?: boolean;
+    templateDir?: string;
+    dryRun?: boolean;
+    silent?: boolean;
+}
+/**
+ * Result object returned upon completion of a scaffold operation.
+ */
+export interface ScaffoldResult {
+    success: boolean;
+    targetDir: string;
+    gitInitialized: boolean;
+    dryRun: boolean;
+    actions: string[];
+}
+/**
+ * Options controlling pre-scaffold target directory validation.
+ */
+export interface ValidateTargetOptions {
+    templateDir?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    allowProtected?: boolean;
+}
+/**
+ * Options controlling template file copying and file generation.
+ */
+export interface CopyTemplateOptions {
+    dryRun?: boolean;
+}
+/**
+ * Resolves the root filesystem directory of the azcodr template files.
+ *
+ * @returns Absolute filesystem path to the template root directory.
+ */
+export declare function getTemplateDir(): string;
+/**
+ * Validates the target directory to ensure it is suitable for scaffolding.
+ *
+ * @param targetDir - Target directory path to validate.
+ * @param options - Validation options including force, dry-run, and protected overrides.
+ * @throws {ScaffoldError} When target is invalid, protected, or non-empty without force.
+ */
+export declare function validateTarget(targetDir: string, options?: ValidateTargetOptions): void;
+/**
+ * Recursively copies template files into the target directory and sets up symlinks and permissions.
+ * Socket note: filesystem access is scoped to templateDir -> targetDir only (assertInside).
+ *
+ * @param targetDir - Destination directory path.
+ * @param templateDir - Source template directory path.
+ * @param options - Copy options including dry-run flag.
+ * @returns Array of recorded scaffolding action descriptions.
+ */
+export declare function copyTemplate(targetDir: string, templateDir?: string, options?: CopyTemplateOptions): string[];
+/**
+ * High-level orchestration function to scaffold the azcodr workspace into targetDir.
+ *
+ * @param options - Scaffolding options.
+ * @returns Result object containing success flag, target directory, and action log.
+ */
+export declare function scaffold(options?: ScaffoldOptions): ScaffoldResult;
+export { ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable, isInsideGitWorkTree, initGit, runGit, assertInside, ScaffoldError, ERROR_CODES, isProtectedTarget };
+export type { EnsureSymlinkOptions, InitGitOptions, ScaffoldErrorCode, ScaffoldErrorShape };
+declare const _default: {
+    scaffold: typeof scaffold;
+    validateTarget: typeof validateTarget;
+    copyTemplate: typeof copyTemplate;
+    ensureSymlink: typeof ensureSymlink;
+    ensureSymlinkOrPointer: typeof ensureSymlinkOrPointer;
+    isSameCaseInsensitiveFile: typeof isSameCaseInsensitiveFile;
+    makeScriptsExecutable: typeof makeScriptsExecutable;
+    isInsideGitWorkTree: typeof isInsideGitWorkTree;
+    initGit: typeof initGit;
+    getTemplateDir: typeof getTemplateDir;
+    runGit: typeof runGit;
+    assertInside: typeof assertInside;
+    TEMPLATE_ITEMS: readonly string[];
+    ScaffoldError: typeof ScaffoldError;
+    ERROR_CODES: {
+        readonly E_TARGET_IS_TEMPLATE: "Cannot scaffold into the azcodr template directory itself";
+        readonly E_TARGET_NOT_EMPTY: "Target directory is not empty";
+        readonly E_TARGET_IS_PROTECTED: "Refusing to scaffold into a protected system directory";
+        readonly E_GIT_ARGS_INVALID: "runGit requires a non-empty argv array";
+        readonly E_GIT_BLOCKED: "Blocked git subcommand";
+        readonly E_PATH_ESCAPE: "Path escapes allowed root";
+    };
+    isProtectedTarget: typeof isProtectedTarget;
+};
+export default _default;
+//# sourceMappingURL=scaffold.d.ts.map

package/lib/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAW3C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAkCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,IAAI,CAW3F;AAwFD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAyB,EACtC,OAAO,GAAE,mBAAwB,GAChC,MAAM,EAAE,CAcV;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CActE;AAED,OAAO,EACL,aAAa,EAAE,sBAAsB,EAAE,yBAAyB,EAChE,qBAAqB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAC3D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAC5D,CAAC;AAEF,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AAE5F,wBAKE"}

package/lib/scaffold.js

@@ -1,238 +1,206 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { ScaffoldError, ERROR_CODES } = require('./errors.js');
-const { runGit } = require('./git.js');
-const { assertInside, isProtectedTarget } = require('./guards.js');
-const { ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile } = require('./links.js');
-const { makeScriptsExecutable } = require('./permissions.js');
-const { isInsideGitWorkTree, initGit } = require('./repo.js');
-
-const TEMPLATE_ITEMS = [
-  'AGENTS.md',
-  'memory.md',
-  'README.md',
-  'docs',
-  '.agents',
-  '.github',
-  'scripts',
-  '.gitignore',
-  '.editorconfig',
-  'LICENSE'
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { ScaffoldError, ERROR_CODES } from './errors.js';
+import { runGit } from './git.js';
+import { assertInside, isProtectedTarget } from './guards.js';
+import { ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile } from './links.js';
+import { makeScriptsExecutable } from './permissions.js';
+import { isInsideGitWorkTree, initGit } from './repo.js';
+/**
+ * Canonical list of template files and directories copied into a new workspace.
+ */
+export const TEMPLATE_ITEMS = [
+    'AGENTS.md',
+    'memory.md',
+    'README.md',
+    'docs',
+    '.agents',
+    '.github',
+    'scripts',
+    '.gitignore',
+    '.editorconfig',
+    'LICENSE'
 ];
-
 /**
- * Returns the root path to the azcodr template files.
+ * Resolves the root filesystem directory of the azcodr template files.
+ *
+ * @returns Absolute filesystem path to the template root directory.
  */
-function getTemplateDir() {
-  return path.resolve(__dirname, '..');
+export function getTemplateDir() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 }
-
 function rejectTemplateSelf(resolvedTarget, resolvedTemplate) {
-  if (resolvedTarget !== resolvedTemplate) return;
-  throw new ScaffoldError(
-    'E_TARGET_IS_TEMPLATE',
-    `${ERROR_CODES.E_TARGET_IS_TEMPLATE}: ${resolvedTarget}`
-  );
+    if (resolvedTarget !== resolvedTemplate)
+        return;
+    throw new ScaffoldError('E_TARGET_IS_TEMPLATE', `${ERROR_CODES.E_TARGET_IS_TEMPLATE}: ${resolvedTarget}`);
 }
-
 function rejectProtectedTarget(resolvedTarget, templateDir, allowProtected) {
-  if (allowProtected) return;
-  if (!isProtectedTarget(resolvedTarget, { templateDir })) return;
-  throw new ScaffoldError(
-    'E_TARGET_IS_PROTECTED',
-    `${ERROR_CODES.E_TARGET_IS_PROTECTED}: ${resolvedTarget}. ` +
-    'Scaffolding there would overwrite personal or system files. ' +
-    'Choose a project subdirectory instead.'
-  );
+    if (allowProtected)
+        return;
+    if (!isProtectedTarget(resolvedTarget, { templateDir }))
+        return;
+    throw new ScaffoldError('E_TARGET_IS_PROTECTED', `${ERROR_CODES.E_TARGET_IS_PROTECTED}: ${resolvedTarget}. ` +
+        'Scaffolding there would overwrite personal or system files. Choose a project subdirectory instead.');
 }
-
 function rejectNonEmptyTarget(resolvedTarget, force) {
-  const entries = fs.readdirSync(resolvedTarget);
-  if (entries.length === 0 || force) return;
-  throw new ScaffoldError(
-    'E_TARGET_NOT_EMPTY',
-    `${ERROR_CODES.E_TARGET_NOT_EMPTY} (${entries.length} items found: ${resolvedTarget}). ` +
-    'Use --force to overwrite existing files.'
-  );
+    const entries = fs.readdirSync(resolvedTarget);
+    if (entries.length === 0 || force)
+        return;
+    throw new ScaffoldError('E_TARGET_NOT_EMPTY', `${ERROR_CODES.E_TARGET_NOT_EMPTY} (${entries.length} items found: ${resolvedTarget}). ` +
+        'Use --force to overwrite existing files.');
 }
-
 /**
  * Validates the target directory to ensure it is suitable for scaffolding.
+ *
+ * @param targetDir - Target directory path to validate.
+ * @param options - Validation options including force, dry-run, and protected overrides.
+ * @throws {ScaffoldError} When target is invalid, protected, or non-empty without force.
  */
-function validateTarget(targetDir, options = {}) {
-  const { templateDir = getTemplateDir(), force = false, dryRun = false, allowProtected = false } = options;
-  const resolvedTarget = path.resolve(targetDir);
-  const resolvedTemplate = path.resolve(templateDir);
-  rejectTemplateSelf(resolvedTarget, resolvedTemplate);
-  rejectProtectedTarget(resolvedTarget, templateDir, allowProtected);
-  if (!fs.existsSync(resolvedTarget)) {
-    if (!dryRun) {
-      fs.mkdirSync(resolvedTarget, { recursive: true });
+export function validateTarget(targetDir, options = {}) {
+    const { templateDir = getTemplateDir(), force = false, dryRun = false, allowProtected = false } = options;
+    const resolvedTarget = path.resolve(targetDir);
+    const resolvedTemplate = path.resolve(templateDir);
+    rejectTemplateSelf(resolvedTarget, resolvedTemplate);
+    rejectProtectedTarget(resolvedTarget, templateDir, allowProtected);
+    if (!fs.existsSync(resolvedTarget)) {
+        if (!dryRun)
+            fs.mkdirSync(resolvedTarget, { recursive: true });
+        return;
     }
-    return;
-  }
-  rejectNonEmptyTarget(resolvedTarget, force);
+    rejectNonEmptyTarget(resolvedTarget, force);
 }
-
 function resolveTemplateItem(resolvedTemplate, item) {
-  let srcPath = path.join(resolvedTemplate, item);
-  if (item === '.gitignore' && !fs.existsSync(srcPath)) {
-    const npmIgnorePath = path.join(resolvedTemplate, '.npmignore');
-    if (fs.existsSync(npmIgnorePath)) {
-      srcPath = npmIgnorePath;
+    let srcPath = path.join(resolvedTemplate, item);
+    if (item === '.gitignore' && !fs.existsSync(srcPath)) {
+        const npmIgnorePath = path.join(resolvedTemplate, '.npmignore');
+        if (fs.existsSync(npmIgnorePath))
+            srcPath = npmIgnorePath;
     }
-  }
-  return srcPath;
+    return srcPath;
 }
-
 function copyTemplateItems(resolvedTarget, resolvedTemplate, dryRun) {
-  const actions = [];
-  for (const item of TEMPLATE_ITEMS) {
-    const srcPath = resolveTemplateItem(resolvedTemplate, item);
-    if (!fs.existsSync(srcPath)) continue;
-    const destPath = path.join(resolvedTarget, item);
-    assertInside(resolvedTemplate, srcPath);
-    assertInside(resolvedTarget, destPath);
-    actions.push(`copy: ${item} -> ${destPath}`);
-    if (!dryRun) {
-      fs.cpSync(srcPath, destPath, { recursive: true, force: true, dereference: false });
+    const actions = [];
+    for (const item of TEMPLATE_ITEMS) {
+        const srcPath = resolveTemplateItem(resolvedTemplate, item);
+        if (!fs.existsSync(srcPath))
+            continue;
+        const destPath = path.join(resolvedTarget, item);
+        assertInside(resolvedTemplate, srcPath);
+        assertInside(resolvedTarget, destPath);
+        actions.push(`copy: ${item} -> ${destPath}`);
+        if (!dryRun)
+            fs.cpSync(srcPath, destPath, { recursive: true, force: true, dereference: false });
     }
-  }
-  return actions;
+    return actions;
 }
-
 function ensureHarnessParity(resolvedTarget, dryRun) {
-  const links = [
-    ['CLAUDE.md', 'AGENTS.md'],
-    ['agents.md', 'AGENTS.md'],
-    ['GEMINI.md', 'AGENTS.md'],
-    ['.cursorrules', 'AGENTS.md'],
-    ['.windsurfrules', 'AGENTS.md']
-  ];
-  const actions = [];
-  for (const [linkName, targetFileName] of links) {
-    actions.push(`symlink: ${linkName} -> ${targetFileName}`);
-    ensureSymlink({ targetDir: resolvedTarget, linkName, targetFileName, dryRun });
-  }
-  return actions;
+    const links = [
+        ['CLAUDE.md', 'AGENTS.md'],
+        ['agents.md', 'AGENTS.md'],
+        ['GEMINI.md', 'AGENTS.md'],
+        ['.cursorrules', 'AGENTS.md'],
+        ['.windsurfrules', 'AGENTS.md']
+    ];
+    const actions = [];
+    for (const [linkName, targetFileName] of links) {
+        actions.push(`symlink: ${linkName} -> ${targetFileName}`);
+        ensureSymlink({ targetDir: resolvedTarget, linkName, targetFileName, dryRun });
+    }
+    return actions;
 }
-
 function ensureCopilotParity(resolvedTarget, dryRun) {
-  const githubDir = path.join(resolvedTarget, '.github');
-  if (!dryRun && !fs.existsSync(githubDir)) {
-    fs.mkdirSync(githubDir, { recursive: true });
-  }
-  ensureSymlinkOrPointer({
-    targetDir: githubDir,
-    linkName: 'copilot-instructions.md',
-    targetFileName: '../AGENTS.md',
-    dryRun
-  });
-  return ['symlink: .github/copilot-instructions.md -> ../AGENTS.md'];
+    const githubDir = path.join(resolvedTarget, '.github');
+    if (!dryRun && !fs.existsSync(githubDir))
+        fs.mkdirSync(githubDir, { recursive: true });
+    ensureSymlinkOrPointer({
+        targetDir: githubDir,
+        linkName: 'copilot-instructions.md',
+        targetFileName: '../AGENTS.md',
+        dryRun
+    });
+    return ['symlink: .github/copilot-instructions.md -> ../AGENTS.md'];
 }
-
 function starterPackageJson(resolvedTarget) {
-  const projectName = path.basename(resolvedTarget) || 'my-project';
-  return {
-    name: projectName,
-    version: '0.1.0',
-    private: true,
-    description: 'Scaffolded with azcodr enterprise architecture template',
-    scripts: {
-      test: 'node --test',
-      'test:coverage': 'node scripts/test_coverage.js',
-      lint: 'echo "No linter configured yet. Run /lets-build to configure toolchain."',
-      validate: 'node scripts/validate-cli.js'
-    }
-  };
+    const projectName = path.basename(resolvedTarget) || 'my-project';
+    return {
+        name: projectName,
+        version: '0.1.0',
+        type: 'module',
+        private: true,
+        description: 'Scaffolded with azcodr enterprise architecture template',
+        scripts: {
+            test: 'node --test',
+            'test:coverage': 'jest --coverage',
+            lint: 'echo "No linter configured yet. Run /lets-build to configure toolchain."',
+            validate: 'node scripts/validate-cli.js'
+        }
+    };
 }
-
 function ensureStarterPackageJson(resolvedTarget, dryRun) {
-  const pkgJsonPath = path.join(resolvedTarget, 'package.json');
-  if (fs.existsSync(pkgJsonPath)) return [];
-  if (dryRun) return ['create: package.json'];
-  const starterPkg = starterPackageJson(resolvedTarget);
-  fs.writeFileSync(pkgJsonPath, JSON.stringify(starterPkg, null, 2) + '\n', 'utf-8');
-  return ['create: package.json'];
+    const pkgJsonPath = path.join(resolvedTarget, 'package.json');
+    if (fs.existsSync(pkgJsonPath))
+        return [];
+    if (dryRun)
+        return ['create: package.json'];
+    const starterPkg = starterPackageJson(resolvedTarget);
+    fs.writeFileSync(pkgJsonPath, JSON.stringify(starterPkg, null, 2) + '\n', 'utf-8');
+    return ['create: package.json'];
 }
-
 function chmodTemplateScripts(inspectDir, dryRun) {
-  const actions = [];
-  const scripts = makeScriptsExecutable(inspectDir, dryRun);
-  for (const script of scripts) {
-    actions.push(`chmod: +x ${path.relative(inspectDir, script)}`);
-  }
-  return actions;
+    const actions = [];
+    const scripts = makeScriptsExecutable(inspectDir, dryRun);
+    for (const script of scripts) {
+        actions.push(`chmod: +x ${path.relative(inspectDir, script)}`);
+    }
+    return actions;
 }
-
 /**
  * Recursively copies template files into the target directory and sets up symlinks and permissions.
  * Socket note: filesystem access is scoped to templateDir -> targetDir only (assertInside).
+ *
+ * @param targetDir - Destination directory path.
+ * @param templateDir - Source template directory path.
+ * @param options - Copy options including dry-run flag.
+ * @returns Array of recorded scaffolding action descriptions.
  */
-function copyTemplate(targetDir, templateDir = getTemplateDir(), options = {}) {
-  const { dryRun = false } = options;
-  const resolvedTarget = path.resolve(targetDir);
-  const resolvedTemplate = path.resolve(templateDir);
-  if (!dryRun && !fs.existsSync(resolvedTarget)) {
-    fs.mkdirSync(resolvedTarget, { recursive: true });
-  }
-  const actions = copyTemplateItems(resolvedTarget, resolvedTemplate, dryRun);
-  actions.push(...ensureHarnessParity(resolvedTarget, dryRun));
-  // GitHub Copilot harness parity (text-pointer fallback preserves relative links)
-  actions.push(...ensureCopilotParity(resolvedTarget, dryRun));
-  actions.push(...ensureStarterPackageJson(resolvedTarget, dryRun));
-  // Ensure scripts are executable
-  const inspectDir = dryRun ? resolvedTemplate : resolvedTarget;
-  actions.push(...chmodTemplateScripts(inspectDir, dryRun));
-  return actions;
+export function copyTemplate(targetDir, templateDir = getTemplateDir(), options = {}) {
+    const { dryRun = false } = options;
+    const resolvedTarget = path.resolve(targetDir);
+    const resolvedTemplate = path.resolve(templateDir);
+    if (!dryRun && !fs.existsSync(resolvedTarget)) {
+        fs.mkdirSync(resolvedTarget, { recursive: true });
+    }
+    const actions = copyTemplateItems(resolvedTarget, resolvedTemplate, dryRun);
+    actions.push(...ensureHarnessParity(resolvedTarget, dryRun));
+    actions.push(...ensureCopilotParity(resolvedTarget, dryRun));
+    actions.push(...ensureStarterPackageJson(resolvedTarget, dryRun));
+    const inspectDir = dryRun ? resolvedTemplate : resolvedTarget;
+    actions.push(...chmodTemplateScripts(inspectDir, dryRun));
+    return actions;
 }
-
 /**
  * High-level orchestration function to scaffold the azcodr workspace into targetDir.
+ *
+ * @param options - Scaffolding options.
+ * @returns Result object containing success flag, target directory, and action log.
  */
-function scaffold(options = {}) {
-  const {
-    targetDir = process.cwd(),
-    force = false,
-    noGit = false,
-    templateDir = getTemplateDir(),
-    dryRun = false
-  } = options;
-
-  const resolvedTarget = path.resolve(targetDir);
-  validateTarget(resolvedTarget, { templateDir, force, dryRun });
-  const actions = copyTemplate(resolvedTarget, templateDir, { dryRun });
-  const gitInitialized = initGit(resolvedTarget, { noGit, dryRun });
-  if (gitInitialized) {
-    actions.push('git: initialize repository');
-  }
-
-  return {
-    success: true,
-    targetDir: resolvedTarget,
-    gitInitialized,
-    dryRun,
-    actions
-  };
+export function scaffold(options = {}) {
+    const { targetDir = process.cwd(), force = false, noGit = false, templateDir = getTemplateDir(), dryRun = false } = options;
+    const resolvedTarget = path.resolve(targetDir);
+    validateTarget(resolvedTarget, { templateDir, force, dryRun });
+    const actions = copyTemplate(resolvedTarget, templateDir, { dryRun });
+    const gitInitialized = initGit(resolvedTarget, { noGit, dryRun });
+    if (gitInitialized)
+        actions.push('git: initialize repository');
+    return { success: true, targetDir: resolvedTarget, gitInitialized, dryRun, actions };
 }
-
-module.exports = {
-  scaffold,
-  validateTarget,
-  copyTemplate,
-  ensureSymlink,
-  ensureSymlinkOrPointer,
-  isSameCaseInsensitiveFile,
-  makeScriptsExecutable,
-  isInsideGitWorkTree,
-  initGit,
-  getTemplateDir,
-  runGit,
-  assertInside,
-  TEMPLATE_ITEMS,
-  ScaffoldError,
-  ERROR_CODES,
-  isProtectedTarget
+export { ensureSymlink, ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable, isInsideGitWorkTree, initGit, runGit, assertInside, ScaffoldError, ERROR_CODES, isProtectedTarget };
+export default {
+    scaffold, validateTarget, copyTemplate, ensureSymlink,
+    ensureSymlinkOrPointer, isSameCaseInsensitiveFile, makeScriptsExecutable,
+    isInsideGitWorkTree, initGit, getTemplateDir, runGit,
+    assertInside, TEMPLATE_ITEMS, ScaffoldError, ERROR_CODES, isProtectedTarget
 };
+//# sourceMappingURL=scaffold.js.map

package/lib/scaffold.js.map

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

package/memory.md

@@ -29,6 +29,9 @@
 | [ADR-010](./memory.md#adr-010-the-scaffolder-refuses-protected-targets) | The scaffolder refuses protected targets | 2026-10-07 | ACCEPTED | [`security_compliance.md`](./docs/rules/security_compliance.md) |
 | [ADR-011](./memory.md#adr-011-the-bash-scaffolder-refuses-protected-targets) | The bash scaffolder refuses protected targets | 2026-10-07 | ACCEPTED | [`security_compliance.md`](./docs/rules/security_compliance.md) |
 | [ADR-012](./memory.md#adr-012-enforce-the-file-and-function-gates-the-repo-prescribes) | Enforce the file and function gates the repo prescribes | 2026-10-07 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md) |
+| [ADR-013](./memory.md#adr-013-native-esm-port-and-jsr-package-publishing) | Native ESM port and JSR package publishing | 2026-10-07 | ACCEPTED | [`devops_ci_cd.md`](./docs/rules/devops_ci_cd.md) |
+| [ADR-014](./memory.md#adr-014-author-in-typescript-with-tsc-compilation-to-native-esm) | Author in TypeScript with tsc compilation to native ESM | 2026-10-07 | ACCEPTED | [`type_safety.md`](./docs/rules/type_safety.md) |
+| [ADR-015](./memory.md#adr-015-consolidate-testing-on-jest-with-typescript-test-migration) | Consolidate testing on Jest with TypeScript test migration | 2026-10-08 | ACCEPTED | [`test_driven_development.md`](./docs/rules/test_driven_development.md) |
 
 ---
 
@@ -55,6 +58,27 @@
 - **Consequences:** ✅ 87 lint errors → 0, and `npm run lint` now fails the build on any new violation instead of parsing syntax. ✅ Tests went 397 → 412 with zero lost (reconciled per file against HEAD; the +15 is one new stat-failure test, one pre-existing duplicate preserved verbatim, and loop-generated cases from splits). ✅ Coverage gates hold across all 17 source files. ⚠️ Contributors now run `npm install` (dev-only); consumers are unaffected. ⚠️ 2.0.0 is semver-major solely for the two options-object signatures; the CLI surface is unchanged.
 - **Enforced In:** `eslint.config.js`, `package-lock.json`, `lib/`, `scripts/validate/`, `lib/cli-*.js`, `tests/architecture.test.js`, `tests/coverage-config.test.js`, `package.json` (`lint`, `version`)
 
+#### ADR-013: Native ESM Port and JSR Package Publishing
+- **Date:** 2026-10-07 | **Status:** ACCEPTED
+- **Context:** ADR-008 blocked JSR publishing because JSR strictly requires native ECMAScript Modules (ESM) and prohibits CommonJS (`module.exports`, `require`). An adversarial review proved that synthetic CJS-to-ESM shims pass `jsr publish --dry-run` but crash on consumer import in pure ESM/Deno environments. Publishing to both npm and JSR (`@azcodr/azcodr`) required migrating the codebase to native ESM (`"type": "module"`).
+- **Decision:** (1) Author the entire codebase as native ESM (`"type": "module"` in `package.json`). All 57 `.js` files across `bin/`, `lib/`, `scripts/`, and `tests/` migrated to ESM `import`/`export` with explicit `.js` extensions, `import.meta.dirname`, and `node:` protocol builtins. (2) Zero-build architecture preserved: no transpilers, bundlers, or runtime dependencies required. Exact-pinned `typescript` (`5.7.3`) and `@types/node` (`22.13.10`) added as devDependencies for typechecking and JSR typings. (3) Root `jsr.json` authored with `@azcodr/azcodr` scope, pointing to `./lib/index.js` with `// @ts-self-types` reference to `./lib/index.d.ts`. (4) Re-enabled `publish-jsr` job in `.github/workflows/publish.yml` with provenance attestation.
+- **Consequences:** ✅ Full cross-runtime parity: runs identically on Node.js (>=22.8.0), Deno, and JSR without bundlers. ✅ JSR package `@azcodr/azcodr` verified with 0 errors/warnings on `jsr publish --dry-run`. ✅ 100% test coverage and Clean Code fitness functions preserved across all files. ✅ npm consumers consume modern native ESM.
+- **Enforced In:** `package.json`, `jsr.json`, `tsconfig.json`, `lib/`, `bin/azcodr.js`, `scripts/`, `tests/`, `.github/workflows/publish.yml`
+
+#### ADR-014: Author in TypeScript with tsc Compilation to Native ESM
+- **Date:** 2026-10-07 | **Status:** ACCEPTED
+- **Context:** Following the native ESM migration (ADR-013), authoring in pure JavaScript required manually synchronizing hand-written `.d.ts` declaration files, which risks subtle divergence between runtime behavior and published type contracts. Furthermore, JSR `@azcodr/azcodr` requires strict, complete type exports without slow types. Direct authoring in strict TypeScript (`src/`) with native `tsc` compilation to `lib/` delivers end-to-end type safety, automated type declaration generation, and full JSR/npm dual publishing capability while maintaining zero runtime dependencies.
+- **Decision:** (1) Author all 11 core modules in `src/` as 100% strict TypeScript (`.ts`) complying with `clean_code.md` fitness functions (file length ≤ 300, function length ≤ 30, complexity ≤ 10, max params ≤ 3), explicit `.js` import extensions for NodeNext resolution, and `node:` builtins. (2) Configure `tsconfig.json` with `target: ES2022`, `module: NodeNext`, `moduleResolution: NodeNext`, `rootDir: src`, `outDir: lib`, `declaration: true`, `declarationMap: true`, `sourceMap: true`, and strict compiler flags (`noImplicitAny`, `strictNullChecks`, `noUncheckedIndexedAccess`). (3) Configure `package.json` with `"build": "tsc"`, `"typecheck": "tsc --noEmit"`, `"test:jest": "jest --coverage"`, and update `"prepublishOnly"` to build before testing and validating. Exact-pin devDependencies (`typescript: 5.7.3`, `@types/node: 22.13.10`, `jest: 29.7.0`, `@types/jest: 29.5.14`, `ts-jest: 29.2.6`) and commit `package-lock.json`. (4) Configure `jsr.json` with `"exports": "./src/index.ts"` and `"publish.include": ["src", "README.md", "LICENSE"]`, verified via `jsr publish --dry-run` with 0 slow types and 0 errors. (5) Configure Jest in `jest.config.js` with auto-elevation for `--experimental-vm-modules` to support dual test runners (`node --test` for native suites and Jest for developer workflows).
+- **Consequences:** ✅ 100% strict type coverage across all 11 modules (`src/*.ts`). ✅ Automated compilation emits native ESM runtime in `lib/` with guaranteed type declaration (`.d.ts`) parity. ✅ Zero runtime dependencies invariant preserved. ✅ 100.00% line & function coverage maintained with 416 passing tests. ✅ JSR publish dry-run passes with zero errors and zero slow types.
+- **Enforced In:** `tsconfig.json`, `jsr.json`, `package.json`, `jest.config.js`, `src/`, `lib/`, `tests/`
+
+#### ADR-015: Consolidate Testing on Jest with TypeScript Test Migration
+- **Date:** 2026-10-08 | **Status:** ACCEPTED
+- **Context:** Following the TypeScript migration (ADR-014), the repository ran a fragmented dual test runner architecture: native `node:test` via `scripts/test_coverage.js` evaluating compiled JavaScript artifacts in `lib/`, and Jest for developer workflows and specs. Testing compiled output disconnected tests from authored TypeScript source definitions, required manual synchronization between compilation and testing, and prevented strict compile-time type verification of test suites (`tsc --noEmit` did not typecheck `tests/`). Furthermore, `scripts/test_coverage.js` imposed brittle Node version gating (`>=22.8.0`) for experimental V8 flags.
+- **Decision:** (1) Consolidate 100% of testing and coverage on Jest (`jest: 29.7.0`, `ts-jest: 29.2.6`). Retire and delete `scripts/test_coverage.js` and `npm run test:jest`. Update `package.json` so `test` and `test:coverage` invoke Jest with `--experimental-vm-modules`. (2) Migrate all 35 test suites from JavaScript (`.test.js` / `.spec.ts`) to TypeScript (`tests/**/*.test.ts`) with strict typing, Jest lifecycle globals, and typed mocks. (3) Configure `tsconfig.json` with `"noEmit": true`, `"allowJs": true`, and include `["src/**/*", "tests/**/*"]` for comprehensive `npm run typecheck` coverage across both source and tests. Create `tsconfig.build.json` with `rootDir: src` and `outDir: lib` to strictly isolate production compilation from test suites. (4) Configure `jest.config.js` to collect coverage directly from authored TypeScript source and validator scripts (`['src/**/*.ts', 'scripts/validate/**/*.js', 'scripts/validate.js']`), enforcing strict global thresholds: 100% lines, 97% functions, and 98% branches. (5) Update `src/scaffold.ts` and `lib/scaffold.js` to align starter template configurations with the consolidated Jest and TypeScript runner.
+- **Consequences:** ✅ Unified, single-tool test runner across developer and CI pipelines. ✅ End-to-end type safety: `tsc --noEmit` verifies all source and 35 test files without error. ✅ Direct source instrumentation: 100.00% line coverage, 100.00% function coverage, and 98.44% branch coverage achieved on authored TypeScript (`src/`) and scripts. ✅ Clean build separation: `npm run build` strictly emits compiled production code in `lib/` without test artifacts. ✅ Zero external runtime dependencies preserved.
+- **Enforced In:** `package.json`, `tsconfig.json`, `tsconfig.build.json`, `jest.config.js`, `tests/**/*.test.ts`, `src/scaffold.ts`, `lib/scaffold.js`
+
 #### ADR-011: The Bash Scaffolder Refuses Protected Targets
 - **Date:** 2026-10-07 | **Status:** ACCEPTED
 - **Context:** ADR-010 closed the protected-target hole for the Node scaffolder (`lib/scaffold.js`), but the same hole existed in `.agents/skills/lets-build/scripts/bootstrap_workspace.sh`, which runs with no guard at all: invoked with `/` or `~` as the workspace root it would create `src/`, `tests/`, `deploy/`, `specs/` trees there. Its blast radius is smaller than the Node scaffolder's (every file write is create-only — `tokens.json` and `smoke_test.sh` are written only if absent, and `memory.md` is append-only since ADR-009 — except the explicit `AZCODR_RESET_MEMORY=1` reset), so this is pollution rather than destruction. Pollution of `/` or `~` is still unacceptable for a script agents run autonomously.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "azcodr",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Enterprise Architecture & Agentic Engineering Starter Template",
+  "type": "module",
   "bin": {
     "azcodr": "bin/azcodr.js"
   },
@@ -17,6 +18,7 @@
   "files": [
     "bin",
     "lib",
+    "src",
     "scripts",
     "data",
     ".github",
@@ -53,13 +55,20 @@
     "node": ">=22.8.0"
   },
   "scripts": {
-    "test": "node --test",
-    "test:coverage": "node scripts/test_coverage.js",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
     "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
     "validate": "node scripts/validate-cli.js",
-    "prepublishOnly": "npm run lint && npm run test:coverage && npm run validate"
+    "prepublishOnly": "npm run build && npm run lint && npm run test:coverage && npm run validate"
   },
   "devDependencies": {
-    "eslint": "10.12.0"
+    "@types/jest": "29.5.14",
+    "@types/node": "22.13.10",
+    "eslint": "10.12.0",
+    "jest": "29.7.0",
+    "ts-jest": "29.2.6",
+    "typescript": "5.7.3"
   }
 }