@aipper/aiws 0.0.28 → 0.0.30

package/src/spec.js

@@ -1,195 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import { pathExists, readText } from "./fs.js";
-import { UserError } from "./errors.js";
-import { validateJsonSchemaLite } from "./json-schema-lite.js";
-
-const specJsonDocCache = new Map();
-
-/**
- * @returns {Promise<{ rootDir: string, version: string }>}
- */
-export async function loadSpecPackage() {
-  const require = createRequire(import.meta.url);
-
-  /** @type {string | null} */
-  let pkgJsonPath = null;
-  try {
-    pkgJsonPath = require.resolve("@aipper/aiws-spec/package.json");
-  } catch {
-    pkgJsonPath = null;
-  }
-
-  /** @type {string} */
-  let rootDir;
-  if (pkgJsonPath) {
-    rootDir = path.dirname(pkgJsonPath);
-  } else {
-    const here = fileURLToPath(import.meta.url);
-    rootDir = path.resolve(path.dirname(here), "../../spec");
-    const fallbackPkg = path.join(rootDir, "package.json");
-    if (!(await pathExists(fallbackPkg))) {
-      throw new UserError("Cannot locate @aipper/aiws-spec. Install it or run inside the monorepo.", {
-        exitCode: 1,
-      });
-    }
-  }
-
-  const pkg = JSON.parse(await readText(path.join(rootDir, "package.json")));
-  const version = String(pkg.version || "").trim() || "0.0.0";
-  return { rootDir, version };
-}
-
-/**
- * @param {string} templateId
- */
-export async function loadTemplate(templateId) {
-  if (!templateId || templateId.includes("..") || templateId.includes("/") || templateId.includes("\\")) {
-    throw new UserError(`Invalid template id: ${templateId}`);
-  }
-
-  const spec = await loadSpecPackage();
-  const templateDir = path.join(spec.rootDir, "templates", templateId);
-  const manifestPath = path.join(templateDir, "manifest.json");
-
-  try {
-    await fs.access(manifestPath);
-  } catch {
-    throw new UserError(`Template not found: ${templateId}`, {
-      details: `Missing: ${manifestPath}`,
-    });
-  }
-
-  const manifest = JSON.parse(await readText(manifestPath));
-  return { templateId, templateDir, manifest, specVersion: spec.version };
-}
-
-/**
- * @param {string} relPath
- */
-async function loadSpecJsonDoc(relPath) {
-  const spec = await loadSpecPackage();
-  const absPath = path.join(spec.rootDir, relPath);
-  const cacheKey = `${spec.rootDir}:${relPath}`;
-  if (specJsonDocCache.has(cacheKey)) {
-    return { spec, data: specJsonDocCache.get(cacheKey), absPath };
-  }
-  const raw = await readText(absPath);
-  let data;
-  try {
-    data = JSON.parse(raw);
-  } catch (error) {
-    throw new UserError(`Invalid JSON in spec doc: ${relPath}`, {
-      details: error instanceof Error ? error.message : String(error),
-    });
-  }
-  specJsonDocCache.set(cacheKey, data);
-  return { spec, data, absPath };
-}
-
-async function loadValidatedSpecJsonDoc(relPath, schemaRelPath) {
-  const loaded = await loadSpecJsonDoc(relPath);
-  const { data: schema } = await loadSpecJsonDoc(schemaRelPath);
-  validateJsonSchemaLite(loaded.data, schema, { source: loaded.absPath });
-  return loaded;
-}
-
-export async function loadWorkflowGovernanceRules() {
-  const relPath = path.join("docs", "workflow-governance-rules.json");
-  const schemaRelPath = path.join("docs", "workflow-governance-rules.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  const governanceRules = data.governanceRules;
-  const guidanceRules = data.guidanceRules;
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-governance-rules.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    description: String(data?.description || ""),
-    governanceRules,
-    guidanceRules,
-  };
-}
-
-export async function loadWorkflowStageContracts() {
-  const relPath = path.join("docs", "workflow-stage-contracts.json");
-  const schemaRelPath = path.join("docs", "workflow-stage-contracts.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  const stages = data.stages;
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-stage-contracts.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    description: String(data?.description || ""),
-    standardChain: Array.isArray(data?.standardChain) ? data.standardChain : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-    stages,
-  };
-}
-
-export async function loadWorkflowRouterRules() {
-  const relPath = path.join("docs", "workflow-router-rules.json");
-  const schemaRelPath = path.join("docs", "workflow-router-rules.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-router-rules.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
-    bootstrapEntry: data.bootstrapEntry,
-    universalSequence: Array.isArray(data?.universalSequence) ? data.universalSequence : [],
-    routingRules: Array.isArray(data?.routingRules) ? data.routingRules : [],
-    routeCases: Array.isArray(data?.routeCases) ? data.routeCases : [],
-    clarificationTriggers: Array.isArray(data?.clarificationTriggers) ? data.clarificationTriggers : [],
-    universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}
-
-export async function loadWorkflowReviewGates() {
-  const relPath = path.join("docs", "workflow-review-gates.json");
-  const schemaRelPath = path.join("docs", "workflow-review-gates.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-review-gates.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    gates: Array.isArray(data?.gates) ? data.gates : [],
-    unifiedRules: Array.isArray(data?.unifiedRules) ? data.unifiedRules : [],
-    evidence: Array.isArray(data?.evidence) ? data.evidence : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}
-
-export async function loadWorkflowDelegationContracts() {
-  const relPath = path.join("docs", "workflow-delegation-contracts.json");
-  const schemaRelPath = path.join("docs", "workflow-delegation-contracts.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-delegation-contracts.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    purpose: Array.isArray(data?.purpose) ? data.purpose : [],
-    truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
-    delegationFlow: Array.isArray(data?.delegationFlow) ? data.delegationFlow : [],
-    roleTypes: Array.isArray(data?.roleTypes) ? data.roleTypes : [],
-    artifactTargets: Array.isArray(data?.artifactTargets) ? data.artifactTargets : [],
-    reviewConvergence: data?.reviewConvergence || {},
-    fallbackMode: data?.fallbackMode || {},
-    toolCapabilityMatrix: Array.isArray(data?.toolCapabilityMatrix) ? data.toolCapabilityMatrix : [],
-    universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}

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}`);
-}
-