@aipper/aiws 0.0.29 → 0.0.30

package/src/template.js

@@ -1,187 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { listFilesRecursive, pathExists, copyFile, readText, writeText, ensureDir } from "./fs.js";
-import { normalizeRel, joinRel } from "./path-utils.js";
-import { normalizeNewlines } from "./hash.js";
-import { extractTemplateBlock, upsertManagedBlock } from "./managed-blocks.js";
-import { UserError } from "./errors.js";
-
-/**
- * Extract a leading YAML frontmatter chunk when present.
- *
- * @param {string} text normalized
- * @returns {{ chunk: string, rest: string } | null}
- */
-function extractLeadingFrontmatter(text) {
-  const t = normalizeNewlines(text);
-  if (!t.startsWith("---\n")) return null;
-  const end = t.indexOf("\n---\n", 4);
-  if (end === -1) return null;
-  const closeEnd = end + "\n---\n".length;
-  return {
-    chunk: t.slice(0, closeEnd),
-    rest: t.slice(closeEnd),
-  };
-}
-
-/**
- * Keep command metadata in sync without overwriting managed-block files wholesale.
- *
- * @param {string} currentText normalized
- * @param {string} templateText normalized
- * @returns {{ nextText: string, changed: boolean }}
- */
-function syncLeadingFrontmatter(currentText, templateText) {
-  const templateFm = extractLeadingFrontmatter(templateText);
-  if (!templateFm) return { nextText: currentText, changed: false };
-
-  const currentFm = extractLeadingFrontmatter(currentText);
-  if (!currentFm) {
-    const nextText = `${templateFm.chunk}${currentText}`;
-    return { nextText, changed: nextText !== currentText };
-  }
-
-  const nextText = `${templateFm.chunk}${currentFm.rest}`;
-  return { nextText, changed: nextText !== currentText };
-}
-
-/**
- * Template file candidates for a given manifest/workspace path.
- *
- * NOTE: npm excludes files named `.gitignore` from published tarballs, even when placed under templates/.
- * We store it as `gitignore` in templates and map it back at runtime.
- *
- * @param {string} relPosix
- * @returns {string[]}
- */
-function templateRelCandidates(relPosix) {
-  const rel = normalizeRel(relPosix);
-  if (!rel) return [];
-  /** @type {string[]} */
-  const out = [rel];
-  if (rel === ".gitignore" || rel.endsWith("/.gitignore")) {
-    out.push(rel.replace(/(^|\/)\.gitignore$/, "$1gitignore"));
-  }
-  return Array.from(new Set(out));
-}
-
-/**
- * Resolve a template source file path for a given workspace-relative path.
- *
- * @param {string} templateDir
- * @param {string} relPosix
- */
-async function resolveTemplateSourcePath(templateDir, relPosix) {
-  for (const cand of templateRelCandidates(relPosix)) {
-    const abs = templatePath(templateDir, cand);
-    if (await pathExists(abs)) return abs;
-  }
-  return templatePath(templateDir, relPosix);
-}
-
-/**
- * Expand manifest paths, supporting patterns ending with `/**`.
- *
- * @param {string} templateDir
- * @param {string[]} entries
- */
-export async function expandManifestEntries(templateDir, entries) {
-  /** @type {Set<string>} */
-  const out = new Set();
-
-  for (const raw of entries) {
-    const e = normalizeRel(raw);
-    if (!e) continue;
-    if (e.includes("**")) {
-      const idx = e.indexOf("**");
-      const prefix = e.slice(0, idx).replace(/\/+$/, "");
-      if (!prefix) continue;
-      const files = await listFilesRecursive(templateDir, prefix);
-      for (const f of files) out.add(normalizeRel(f));
-      continue;
-    }
-    out.add(e);
-  }
-
-  return Array.from(out).sort();
-}
-
-/**
- * @param {string} templateDir
- * @param {string} relPosix
- */
-export function templatePath(templateDir, relPosix) {
-  const rel = normalizeRel(relPosix);
-  return path.join(templateDir, ...rel.split("/"));
-}
-
-/**
- * Copy a template file to workspace, creating parent directories.
- *
- * @param {{ templateDir: string, workspaceRoot: string, relPosix: string, chmod?: number }} options
- */
-export async function copyTemplateFileToWorkspace(options) {
-  const rel = normalizeRel(options.relPosix);
-  const src = await resolveTemplateSourcePath(options.templateDir, rel);
-  const dest = joinRel(options.workspaceRoot, rel);
-  if (!(await pathExists(src))) {
-    const tried = templateRelCandidates(rel).map((c) => templatePath(options.templateDir, c));
-    throw new UserError(`Template file missing: ${options.relPosix}`, { details: `Tried:\n- ${tried.join("\n- ")}` });
-  }
-  await copyFile(src, dest, typeof options.chmod === "number" ? { chmod: options.chmod } : undefined);
-}
-
-/**
- * Upsert one or more managed blocks from template into an existing workspace file.
- *
- * @param {{ templateDir: string, workspaceRoot: string, fileRel: string, blockIds: string[], insertIfMissing: boolean }} options
- * @returns {Promise<{ changed: boolean }>}
- */
-export async function applyManagedBlocksFromTemplate(options) {
-  const fileRel = normalizeRel(options.fileRel);
-  const dest = joinRel(options.workspaceRoot, fileRel);
-  const src = await resolveTemplateSourcePath(options.templateDir, fileRel);
-
-  if (!(await pathExists(src))) {
-    const tried = templateRelCandidates(fileRel).map((c) => templatePath(options.templateDir, c));
-    throw new UserError(`Template file missing: ${fileRel}`, { details: `Tried:\n- ${tried.join("\n- ")}` });
-  }
-  const templateText = normalizeNewlines(await readText(src));
-
-  if (!(await pathExists(dest))) {
-    await ensureDir(path.dirname(dest));
-    await writeText(dest, templateText);
-    return { changed: true };
-  }
-
-  const currentText = normalizeNewlines(await readText(dest));
-  const syncedFrontmatter = syncLeadingFrontmatter(currentText, templateText);
-  let nextText = syncedFrontmatter.nextText;
-  let anyChanged = syncedFrontmatter.changed;
-
-  for (const blockId of options.blockIds) {
-    const { blockChunk, innerText } = extractTemplateBlock(templateText, blockId);
-    const res = upsertManagedBlock(nextText, blockId, innerText, {
-      insertIfMissing: options.insertIfMissing,
-      templateBlockChunk: blockChunk,
-    });
-    nextText = res.nextText;
-    if (res.changed) anyChanged = true;
-  }
-
-  if (anyChanged) {
-    await writeText(dest, nextText);
-  }
-  return { changed: anyChanged };
-}
-
-/**
- * Ensure workspace has a directory.
- *
- * @param {string} workspaceRoot
- * @param {string} relPosix
- */
-export async function ensureWorkspaceDir(workspaceRoot, relPosix) {
-  const abs = joinRel(workspaceRoot, relPosix);
-  await fs.mkdir(abs, { recursive: true });
-}

package/src/workspace.js

@@ -1,23 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { pathExists } from "./fs.js";
-import { UserError } from "./errors.js";
-
-/**
- * @param {string} targetPath
- * @param {{ create?: boolean }=} options
- */
-export async function resolveWorkspaceRoot(targetPath, options) {
-  const abs = path.resolve(process.cwd(), targetPath || ".");
-  if (await pathExists(abs)) {
-    const st = await fs.stat(abs);
-    if (!st.isDirectory()) throw new UserError(`Not a directory: ${abs}`);
-    return abs;
-  }
-  if (options?.create) {
-    await fs.mkdir(abs, { recursive: true });
-    return abs;
-  }
-  throw new UserError(`Path does not exist: ${abs}`);
-}
-