@aipper/aiws 0.0.1 → 0.0.2

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@aipper/aiws",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "AI Workspace CLI (init/update/validate) for Claude Code / OpenCode / Codex / iFlow.",
   "type": "module",
   "bin": {
     "aiws": "./bin/aiws.js"
   },
   "dependencies": {
-    "@aipper/aiws-spec": "0.0.1"
+    "@aipper/aiws-spec": "0.0.2"
   },
   "files": [
     "bin",

package/src/template.js

@@ -6,6 +6,40 @@ import { normalizeNewlines } from "./hash.js";
 import { extractTemplateBlock, upsertManagedBlock } from "./managed-blocks.js";
 import { UserError } from "./errors.js";
 
+/**
+ * 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 `/**`.
  *
@@ -48,9 +82,13 @@ export function templatePath(templateDir, relPosix) {
  * @param {{ templateDir: string, workspaceRoot: string, relPosix: string, chmod?: number }} options
  */
 export async function copyTemplateFileToWorkspace(options) {
-  const src = templatePath(options.templateDir, options.relPosix);
-  const dest = joinRel(options.workspaceRoot, options.relPosix);
-  if (!(await pathExists(src))) throw new UserError(`Template file missing: ${options.relPosix}`, { details: `Missing: ${src}` });
+  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);
 }
 
@@ -63,9 +101,12 @@ export async function copyTemplateFileToWorkspace(options) {
 export async function applyManagedBlocksFromTemplate(options) {
   const fileRel = normalizeRel(options.fileRel);
   const dest = joinRel(options.workspaceRoot, fileRel);
-  const src = templatePath(options.templateDir, fileRel);
+  const src = await resolveTemplateSourcePath(options.templateDir, fileRel);
 
-  if (!(await pathExists(src))) throw new UserError(`Template file missing: ${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))) {
@@ -104,4 +145,3 @@ export async function ensureWorkspaceDir(workspaceRoot, relPosix) {
   const abs = joinRel(workspaceRoot, relPosix);
   await fs.mkdir(abs, { recursive: true });
 }
-