azcodr 2.2.0 → 2.4.0

package/src/scaffold.ts

@@ -1,17 +1,18 @@
 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 type { ScaffoldErrorCode, ScaffoldErrorShape } from './errors.js';
 import { runGit } from './git.js';
-import { assertInside, isProtectedTarget } from './guards.js';
+import { assertInside, isProtectedTarget, getTemplateDir } 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';
 
+export { getTemplateDir };
+
 /**
  * Canonical list of template files and directories copied into a new workspace.
  */
@@ -68,14 +69,6 @@ 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 function getTemplateDir(): string {
-  return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-}
 
 function rejectTemplateSelf(resolvedTarget: string, resolvedTemplate: string): void {
   if (resolvedTarget !== resolvedTemplate) return;
@@ -130,6 +123,10 @@ export function validateTarget(targetDir: string, options: ValidateTargetOptions
 }
 
 function resolveTemplateItem(resolvedTemplate: string, item: string): string {
+  if (item === 'memory.md') {
+    const memTpl = path.join(resolvedTemplate, 'data', 'memory.template');
+    if (fs.existsSync(memTpl)) return memTpl;
+  }
   let srcPath = path.join(resolvedTemplate, item);
   if (item === '.gitignore' && !fs.existsSync(srcPath)) {
     const npmIgnorePath = path.join(resolvedTemplate, '.npmignore');

package/src/validate.ts

@@ -0,0 +1,47 @@
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+export interface ValidationResult {
+  errors: number;
+  warnings: number;
+  validatedRules: number;
+  validatedSkills: number;
+  totalLinks: number;
+  brokenLinks: string[];
+}
+
+export interface ValidationReporter {
+  pass: (msg: string) => void;
+  warn: (msg: string) => void;
+  fail: (msg: string) => void;
+  log: (msg: string) => void;
+  heading: (msg: string) => void;
+}
+
+/**
+ * Validates the agentic architecture and governance files of a workspace.
+ *
+ * @param workspaceRoot - Path to the workspace directory (defaults to cwd).
+ * @param reporter - Optional custom reporter hooks.
+ * @returns Object containing error and warning tallies and validation counts.
+ */
+export async function validate(
+  workspaceRoot: string = process.cwd(),
+  reporter?: ValidationReporter
+): Promise<ValidationResult> {
+  const baseDir = import.meta.dirname ?? path.dirname(fileURLToPath(import.meta.url));
+  const scriptPath = path.resolve(baseDir, '../scripts/validate.js');
+  const mod = await import(pathToFileURL(scriptPath).href);
+  return mod.runValidation(path.resolve(workspaceRoot), reporter);
+}
+
+const noop = (): void => {};
+
+/**
+ * Creates a silent reporter that suppresses all status reports.
+ */
+export function createSilentReporter(): ValidationReporter {
+  return { pass: noop, warn: noop, fail: noop, log: noop, heading: noop };
+}
+
+export default { validate, createSilentReporter };