@stacksjs/ai 0.70.258 → 0.70.259

package/dist/client.js

@@ -1,194 +1,4 @@
-import * as anthropic from "./drivers/anthropic";
-import * as ollama from "./drivers/ollama";
-import * as openai from "./drivers/openai";
-function textContent(content) {
-  if (typeof content === "string")
-    return content;
-  return content.filter((block) => block.type === "text").map((block) => block.text ?? "").join(`
-`);
-}
-export function resolveAIProvider(config, override) {
-  if (override)
-    return override;
-  const configured = String(config.default || "").toLowerCase();
-  if (configured === "anthropic" || configured.startsWith("anthropic."))
-    return "anthropic";
-  if (configured === "openai" || configured.startsWith("gpt-") || configured.startsWith("o1") || configured.startsWith("o3"))
-    return "openai";
-  if (configured === "ollama")
-    return "ollama";
-  throw Error(`Unsupported configured AI driver: ${config.default || "(empty)"}. Expected anthropic, openai, or ollama.`);
-}
-function configuredModel(config, provider) {
-  const driverModel = config.drivers?.[provider]?.model?.trim();
-  if (driverModel)
-    return driverModel;
-  const configuredDefault = String(config.default || "").trim();
-  if (!configuredDefault || configuredDefault.toLowerCase() === provider)
-    return;
-  return configuredDefault;
-}
-export function getAIProviderConfiguration(config, override, environment = process.env) {
-  const provider = resolveAIProvider(config, override), driver = config.drivers?.[provider] ?? {}, model = configuredModel(config, provider);
-  if (provider === "ollama")
-    return { provider, model, configured: !0, source: "local" };
-  if (driver.apiKey?.trim())
-    return { provider, model, configured: !0, source: "config" };
-  if (environment[provider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY"]?.trim())
-    return { provider, model, configured: !0, source: "environment" };
-  if (driver.baseUrl?.trim())
-    return { provider, model, configured: !0, source: "base-url" };
-  return { provider, model, configured: !1, source: "none" };
-}
-function parseObject(content) {
-  const unfenced = content.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
-  try {
-    return JSON.parse(unfenced);
-  } catch {
-    const start = unfenced.indexOf("{"), end = unfenced.lastIndexOf("}");
-    if (start >= 0 && end > start)
-      return JSON.parse(unfenced.slice(start, end + 1));
-    throw Error("AI response did not contain a valid JSON object");
-  }
-}
-function typeMatches(value, type) {
-  if (type === "array")
-    return Array.isArray(value);
-  if (type === "integer")
-    return typeof value === "number" && Number.isInteger(value);
-  if (type === "object")
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-  if (type === "null")
-    return value === null;
-  return typeof value === type;
-}
-function validateSchema(value, schema, path = "$") {
-  const errors = [];
-  if (schema.type) {
-    const allowed = Array.isArray(schema.type) ? schema.type : [schema.type];
-    if (!allowed.some((type) => typeMatches(value, type)))
-      return [`${path} must be ${allowed.join(" or ")}`];
-  }
-  if (schema.enum && !schema.enum.some((candidate) => Object.is(candidate, value)))
-    errors.push(`${path} must be one of ${schema.enum.join(", ")}`);
-  if (typeof value === "string") {
-    if (schema.minLength !== void 0 && value.length < schema.minLength)
-      errors.push(`${path} must contain at least ${schema.minLength} characters`);
-    if (schema.maxLength !== void 0 && value.length > schema.maxLength)
-      errors.push(`${path} must contain at most ${schema.maxLength} characters`);
-  }
-  if (typeof value === "number") {
-    if (schema.minimum !== void 0 && value < schema.minimum)
-      errors.push(`${path} must be at least ${schema.minimum}`);
-    if (schema.maximum !== void 0 && value > schema.maximum)
-      errors.push(`${path} must be at most ${schema.maximum}`);
-  }
-  if (Array.isArray(value)) {
-    if (schema.minItems !== void 0 && value.length < schema.minItems)
-      errors.push(`${path} must contain at least ${schema.minItems} items`);
-    if (schema.maxItems !== void 0 && value.length > schema.maxItems)
-      errors.push(`${path} must contain at most ${schema.maxItems} items`);
-    if (schema.items)
-      value.forEach((item, index) => errors.push(...validateSchema(item, schema.items, `${path}[${index}]`)));
-  }
-  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-    const record = value;
-    for (const key of schema.required ?? [])
-      if (!(key in record))
-        errors.push(`${path}.${key} is required`);
-    for (const [key, child] of Object.entries(schema.properties ?? {}))
-      if (key in record)
-        errors.push(...validateSchema(record[key], child, `${path}.${key}`));
-    if (schema.additionalProperties === !1) {
-      const known = new Set(Object.keys(schema.properties ?? {}));
-      for (const key of Object.keys(record))
-        if (!known.has(key))
-          errors.push(`${path}.${key} is not allowed`);
-    }
-  }
-  return errors;
-}
-function createGenerate(config, provider) {
-  if (provider === "anthropic") {
-    const driver = config.drivers?.anthropic ?? {};
-    anthropic.configure({
-      apiKey: driver.apiKey || process.env.ANTHROPIC_API_KEY || "",
-      model: driver.model,
-      maxTokens: driver.maxTokens,
-      anthropicVersion: driver.anthropicVersion
-    });
-    return async (messages, options = {}) => {
-      const systemMessages = messages.filter((message) => message.role === "system").map((message) => textContent(message.content)), nonSystem = messages.filter((message) => message.role !== "system");
-      return anthropic.chat(nonSystem, {
-        ...options,
-        system: [options.system, ...systemMessages].filter(Boolean).join(`
+import*as anthropic from"./drivers/anthropic";import*as ollama from"./drivers/ollama";import*as openai from"./drivers/openai";function textContent(content){if(typeof content==="string")return content;return content.filter((block)=>block.type==="text").map((block)=>block.text??"").join(`
+`)}export function resolveAIProvider(config,override){if(override)return override;const configured=String(config.default||"").toLowerCase();if(configured==="anthropic"||configured.startsWith("anthropic."))return"anthropic";if(configured==="openai"||configured.startsWith("gpt-")||configured.startsWith("o1")||configured.startsWith("o3"))return"openai";if(configured==="ollama")return"ollama";throw Error(`Unsupported configured AI driver: ${config.default||"(empty)"}. Expected anthropic, openai, or ollama.`)}function configuredModel(config,provider){const driverModel=config.drivers?.[provider]?.model?.trim();if(driverModel)return driverModel;const configuredDefault=String(config.default||"").trim();if(!configuredDefault||configuredDefault.toLowerCase()===provider)return;return configuredDefault}export function getAIProviderConfiguration(config,override,environment=process.env){const provider=resolveAIProvider(config,override),driver=config.drivers?.[provider]??{},model=configuredModel(config,provider);if(provider==="ollama")return{provider,model,configured:!0,source:"local"};if(driver.apiKey?.trim())return{provider,model,configured:!0,source:"config"};if(environment[provider==="openai"?"OPENAI_API_KEY":"ANTHROPIC_API_KEY"]?.trim())return{provider,model,configured:!0,source:"environment"};if(driver.baseUrl?.trim())return{provider,model,configured:!0,source:"base-url"};return{provider,model,configured:!1,source:"none"}}function parseObject(content){const unfenced=content.trim().replace(/^```(?:json)?\s*/i,"").replace(/\s*```$/,"");try{return JSON.parse(unfenced)}catch{const start=unfenced.indexOf("{"),end=unfenced.lastIndexOf("}");if(start>=0&&end>start)return JSON.parse(unfenced.slice(start,end+1));throw Error("AI response did not contain a valid JSON object")}}function typeMatches(value,type){if(type==="array")return Array.isArray(value);if(type==="integer")return typeof value==="number"&&Number.isInteger(value);if(type==="object")return typeof value==="object"&&value!==null&&!Array.isArray(value);if(type==="null")return value===null;return typeof value===type}function validateSchema(value,schema,path="$"){const errors=[];if(schema.type){const allowed=Array.isArray(schema.type)?schema.type:[schema.type];if(!allowed.some((type)=>typeMatches(value,type)))return[`${path} must be ${allowed.join(" or ")}`]}if(schema.enum&&!schema.enum.some((candidate)=>Object.is(candidate,value)))errors.push(`${path} must be one of ${schema.enum.join(", ")}`);if(typeof value==="string"){if(schema.minLength!==void 0&&value.length<schema.minLength)errors.push(`${path} must contain at least ${schema.minLength} characters`);if(schema.maxLength!==void 0&&value.length>schema.maxLength)errors.push(`${path} must contain at most ${schema.maxLength} characters`)}if(typeof value==="number"){if(schema.minimum!==void 0&&value<schema.minimum)errors.push(`${path} must be at least ${schema.minimum}`);if(schema.maximum!==void 0&&value>schema.maximum)errors.push(`${path} must be at most ${schema.maximum}`)}if(Array.isArray(value)){if(schema.minItems!==void 0&&value.length<schema.minItems)errors.push(`${path} must contain at least ${schema.minItems} items`);if(schema.maxItems!==void 0&&value.length>schema.maxItems)errors.push(`${path} must contain at most ${schema.maxItems} items`);if(schema.items)value.forEach((item,index)=>errors.push(...validateSchema(item,schema.items,`${path}[${index}]`)))}if(typeof value==="object"&&value!==null&&!Array.isArray(value)){const record=value;for(const key of schema.required??[])if(!(key in record))errors.push(`${path}.${key} is required`);for(const[key,child]of Object.entries(schema.properties??{}))if(key in record)errors.push(...validateSchema(record[key],child,`${path}.${key}`));if(schema.additionalProperties===!1){const known=new Set(Object.keys(schema.properties??{}));for(const key of Object.keys(record))if(!known.has(key))errors.push(`${path}.${key} is not allowed`)}}return errors}function createGenerate(config,provider){if(provider==="anthropic"){const driver=config.drivers?.anthropic??{};anthropic.configure({apiKey:driver.apiKey||process.env.ANTHROPIC_API_KEY||"",model:driver.model,maxTokens:driver.maxTokens,anthropicVersion:driver.anthropicVersion});return async(messages,options={})=>{const systemMessages=messages.filter((message)=>message.role==="system").map((message)=>textContent(message.content)),nonSystem=messages.filter((message)=>message.role!=="system");return anthropic.chat(nonSystem,{...options,system:[options.system,...systemMessages].filter(Boolean).join(`
 
-`) || void 0
-      });
-    };
-  }
-  if (provider === "openai") {
-    const driver = config.drivers?.openai ?? {};
-    openai.configure({
-      apiKey: driver.apiKey || process.env.OPENAI_API_KEY || "",
-      model: driver.model,
-      maxTokens: driver.maxTokens,
-      baseUrl: driver.baseUrl,
-      embeddingModel: driver.embeddingModel
-    });
-    return (messages, options = {}) => {
-      const finalMessages = options.system ? [{ role: "system", content: options.system }, ...messages] : messages;
-      return openai.chat(finalMessages, options);
-    };
-  }
-  const driver = config.drivers?.ollama ?? {};
-  ollama.configure({
-    host: driver.host || driver.baseUrl,
-    model: driver.model,
-    embeddingModel: driver.embeddingModel
-  });
-  return (messages, options = {}) => {
-    const finalMessages = options.system ? [{ role: "system", content: options.system }, ...messages] : messages;
-    return ollama.chat(finalMessages, options);
-  };
-}
-export function createAIClient(config, override) {
-  const provider = resolveAIProvider(config, override), configuration = getAIProviderConfiguration(config, provider), generate = createGenerate(config, provider);
-  return {
-    provider,
-    configuration,
-    generate,
-    async generateObject(messages, schema, options = {}) {
-      const { attempts = 2, system, ...completionOptions } = options, history = [...messages];
-      let lastError;
-      for (let attempt = 1;attempt <= Math.max(1, attempts); attempt++) {
-        const result = await generate(history, {
-          ...completionOptions,
-          system,
-          responseFormat: {
-            type: "json_schema",
-            json_schema: { name: "structured_output", schema, strict: !0 }
-          }
-        });
-        try {
-          const data = parseObject(result.content), errors = validateSchema(data, schema);
-          if (errors.length)
-            throw Error(`AI response failed schema validation: ${errors.slice(0, 8).join("; ")}`);
-          return { data, result };
-        } catch (error) {
-          lastError = error instanceof Error ? error : Error(String(error));
-          if (attempt < attempts) {
-            history.push({ role: "assistant", content: result.content });
-            history.push({
-              role: "user",
-              content: `Return only a corrected JSON object. Validation error: ${lastError.message}`
-            });
-          }
-        }
-      }
-      throw lastError ?? Error("AI object generation failed");
-    }
-  };
-}
-
-export { parseObject as parseAIObject, validateSchema as validateAISchema };
+`)||void 0})}}if(provider==="openai"){const driver=config.drivers?.openai??{};openai.configure({apiKey:driver.apiKey||process.env.OPENAI_API_KEY||"",model:driver.model,maxTokens:driver.maxTokens,baseUrl:driver.baseUrl,embeddingModel:driver.embeddingModel});return(messages,options={})=>{const finalMessages=options.system?[{role:"system",content:options.system},...messages]:messages;return openai.chat(finalMessages,options)}}const driver=config.drivers?.ollama??{};ollama.configure({host:driver.host||driver.baseUrl,model:driver.model,embeddingModel:driver.embeddingModel});return(messages,options={})=>{const finalMessages=options.system?[{role:"system",content:options.system},...messages]:messages;return ollama.chat(finalMessages,options)}}export function createAIClient(config,override){const provider=resolveAIProvider(config,override),configuration=getAIProviderConfiguration(config,provider),generate=createGenerate(config,provider);return{provider,configuration,generate,async generateObject(messages,schema,options={}){const{attempts=2,system,...completionOptions}=options,history=[...messages];let lastError;for(let attempt=1;attempt<=Math.max(1,attempts);attempt++){const result=await generate(history,{...completionOptions,system,responseFormat:{type:"json_schema",json_schema:{name:"structured_output",schema,strict:!0}}});try{const data=parseObject(result.content),errors=validateSchema(data,schema);if(errors.length)throw Error(`AI response failed schema validation: ${errors.slice(0,8).join("; ")}`);return{data,result}}catch(error){lastError=error instanceof Error?error:Error(String(error));if(attempt<attempts){history.push({role:"assistant",content:result.content});history.push({role:"user",content:`Return only a corrected JSON object. Validation error: ${lastError.message}`})}}}throw lastError??Error("AI object generation failed")}}}export{parseObject as parseAIObject,validateSchema as validateAISchema};

package/dist/context.js

@@ -1,200 +1,9 @@
-import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
-import { basename, relative, resolve, sep } from "node:path";
-import { estimateTokens } from "./utils/tokens";
-export const STACKS_PROJECT_CONTEXT_SCHEMA = "https://stacksjs.org/schemas/ai-project-context/v1";
-const DEFAULT_MAX_CHARS = 4000, DEFAULT_MAX_FILES = 30, excludedSegments = new Set([
-  ".git",
-  ".bun",
-  ".cache",
-  ".next",
-  ".output",
-  ".turbo",
-  ".vite",
-  "build",
-  "coverage",
-  "dist",
-  "node_modules",
-  "tmp",
-  "vendor"
-]), sensitiveNames = /^(?:\.env(?:\..*)?|\.npmrc|\.pypirc|credentials(?:\..*)?|id_(?:rsa|ed25519)(?:\.pub)?|secrets?(?:\..*)?)$/i, lockNames = /(?:^|\.)(?:bun|package-lock|pnpm-lock|yarn|pantry)\.?(?:lock|yaml)?$/i, surfaceDefinitions = [
-  { id: "models", purpose: "Domain schema, validation, relationships, factories, and traits.", prefixes: ["app/Models/", "storage/framework/defaults/app/Models/"] },
-  { id: "actions", purpose: "Transport-independent application behavior.", prefixes: ["app/Actions/", "storage/framework/defaults/app/Actions/"] },
-  { id: "routes", purpose: "HTTP and API route registration.", prefixes: ["routes/", "app/Routes.ts"] },
-  { id: "jobs", purpose: "Background and inline work.", prefixes: ["app/Jobs/", "storage/framework/defaults/app/Jobs/"] },
-  { id: "configuration", purpose: "Typed application and provider configuration.", prefixes: ["config/"] },
-  { id: "views", purpose: "STX views, layouts, components, and client functions.", prefixes: ["resources/"] },
-  { id: "database", purpose: "Reviewable migrations and seed data.", prefixes: ["database/"] },
-  { id: "tests", purpose: "Unit, feature, contract, and end-to-end evidence.", prefixes: ["tests/", "storage/framework/core/"] }
-];
-function normalizePath(path) {
-  return path.split(sep).join("/");
-}
-function isExcluded(path) {
-  const segments = path.split("/"), name = basename(path);
-  return segments.some((segment) => excludedSegments.has(segment)) || sensitiveNames.test(name) || lockNames.test(name) || name.endsWith(".lock");
-}
-function collectFiles(root) {
-  const files = [];
-  function visit(directory) {
-    const entries = readdirSync(directory, { withFileTypes: !0 }).sort((a, b) => a.name.localeCompare(b.name));
-    for (const entry of entries) {
-      const fullPath = resolve(directory, entry.name), projectPath = normalizePath(relative(root, fullPath));
-      if (isExcluded(projectPath))
-        continue;
-      if (entry.isDirectory())
-        visit(fullPath);
-      else if (entry.isFile() && !lstatSync(fullPath).isSymbolicLink())
-        files.push(projectPath);
-    }
-  }
-  visit(root);
-  return files.sort((a, b) => a.localeCompare(b));
-}
-function readPackageSummary(root) {
-  const packagePath = resolve(root, "package.json");
-  if (!existsSync(packagePath))
-    return { name: null, version: null, scripts: [], dependencies: [] };
-  try {
-    const manifest = JSON.parse(readFileSync(packagePath, "utf8")), dependencies = [
-      ...Object.keys(manifest.dependencies || {}),
-      ...Object.keys(manifest.devDependencies || {}),
-      ...Object.keys(manifest.peerDependencies || {})
-    ];
-    return {
-      name: typeof manifest.name === "string" ? manifest.name : null,
-      version: typeof manifest.version === "string" ? manifest.version : null,
-      scripts: Object.keys(manifest.scripts || {}).sort().slice(0, 25),
-      dependencies: [...new Set(dependencies)].sort().slice(0, 30)
-    };
-  } catch {
-    return { name: null, version: null, scripts: [], dependencies: [] };
-  }
-}
-function filePriority(path) {
-  if (/^(?:AGENTS|CLAUDE)\.md$|^\.github\/copilot-instructions\.md$/.test(path))
-    return 0;
-  if (path === "package.json" || path === "app/Routes.ts" || path === "app/Commands.ts")
-    return 1;
-  if (/^(?:app|routes|config)\//.test(path))
-    return 2;
-  if (/^(?:resources|database|tests)\//.test(path))
-    return 3;
-  if (/^docs\//.test(path))
-    return 4;
-  if (/^storage\/framework\/defaults\//.test(path))
-    return 5;
-  return 6;
-}
-function representativeFiles(files, maxFiles) {
-  return [...files].sort((a, b) => filePriority(a) - filePriority(b) || a.localeCompare(b)).slice(0, maxFiles).sort((a, b) => a.localeCompare(b));
-}
-function surfacePaths(files, prefixes) {
-  return files.filter((file) => prefixes.some((prefix) => prefix.endsWith("/") ? file.startsWith(prefix) : file === prefix)).slice(0, 4);
-}
-function renderContext(context) {
-  return [
-    "Stacks AI Project Context v1",
-    "",
-    `Project: ${context.project.name || "unnamed"}${context.project.version ? `@${context.project.version}` : ""}`,
-    "Architecture: Model-View-Action",
-    `Override rule: ${context.architecture.overrideRule}`,
-    `Authoring order: ${context.architecture.authoringOrder.join(" -> ")}`,
-    "",
-    "Authoring principles:",
-    ...context.architecture.principles.map((principle) => `- ${principle}`),
-    "",
-    "Instruction files:",
-    ...context.instructionFiles.length ? context.instructionFiles.map((file) => `- ${file}`) : ["- none detected"],
-    "",
-    "Available surfaces:",
-    ...context.surfaces.flatMap((surface) => [
-      `- ${surface.id}: ${surface.purpose}`,
-      ...surface.paths.map((path) => `  - ${path}`)
-    ]),
-    "",
-    `Scripts: ${context.project.scripts.join(", ") || "none detected"}`,
-    `Dependencies: ${context.project.dependencies.join(", ") || "none detected"}`,
-    "",
-    "Representative files:",
-    ...context.representativeFiles.map((file) => `- ${file}`)
-  ].join(`
-`);
-}
-function fitToBudget(text, maxChars) {
-  if (text.length <= maxChars)
-    return { text, truncated: !1 };
-  const marker = `
-[context truncated by character budget]`;
-  if (maxChars <= marker.length)
-    return { text: marker.slice(0, maxChars), truncated: !0 };
-  const available = maxChars - marker.length, prefix = text.slice(0, available), lastLine = prefix.lastIndexOf(`
-`);
-  return {
-    text: `${prefix.slice(0, lastLine > 0 ? lastLine : available)}${marker}`,
-    truncated: !0
-  };
-}
-function unstructuredBaseline(root, files) {
-  const readmePath = resolve(root, "README.md"), packagePath = resolve(root, "package.json"), readme = existsSync(readmePath) ? readFileSync(readmePath, "utf8").slice(0, 2000) : "", packageJson = existsSync(packagePath) ? readFileSync(packagePath, "utf8") : "";
-  return [
-    "Repository Structure:",
-    files.slice(0, 50).join(`
-`),
-    readme ? `README.md (excerpt):
-${readme}` : "",
-    packageJson ? `package.json:
-${packageJson}` : ""
-  ].filter(Boolean).join(`
+import{existsSync,lstatSync,readFileSync,readdirSync}from"node:fs";import{basename,relative,resolve,sep}from"node:path";import{estimateTokens}from"./utils/tokens";export const STACKS_PROJECT_CONTEXT_SCHEMA="https://stacksjs.org/schemas/ai-project-context/v1";const DEFAULT_MAX_CHARS=4000,DEFAULT_MAX_FILES=30,excludedSegments=new Set([".git",".bun",".cache",".next",".output",".turbo",".vite","build","coverage","dist","node_modules","tmp","vendor"]),sensitiveNames=/^(?:\.env(?:\..*)?|\.npmrc|\.pypirc|credentials(?:\..*)?|id_(?:rsa|ed25519)(?:\.pub)?|secrets?(?:\..*)?)$/i,lockNames=/(?:^|\.)(?:bun|package-lock|pnpm-lock|yarn|pantry)\.?(?:lock|yaml)?$/i,surfaceDefinitions=[{id:"models",purpose:"Domain schema, validation, relationships, factories, and traits.",prefixes:["app/Models/","storage/framework/defaults/app/Models/"]},{id:"actions",purpose:"Transport-independent application behavior.",prefixes:["app/Actions/","storage/framework/defaults/app/Actions/"]},{id:"routes",purpose:"HTTP and API route registration.",prefixes:["routes/","app/Routes.ts"]},{id:"jobs",purpose:"Background and inline work.",prefixes:["app/Jobs/","storage/framework/defaults/app/Jobs/"]},{id:"configuration",purpose:"Typed application and provider configuration.",prefixes:["config/"]},{id:"views",purpose:"STX views, layouts, components, and client functions.",prefixes:["resources/"]},{id:"database",purpose:"Reviewable migrations and seed data.",prefixes:["database/"]},{id:"tests",purpose:"Unit, feature, contract, and end-to-end evidence.",prefixes:["tests/","storage/framework/core/"]}];function normalizePath(path){return path.split(sep).join("/")}function isExcluded(path){const segments=path.split("/"),name=basename(path);return segments.some((segment)=>excludedSegments.has(segment))||sensitiveNames.test(name)||lockNames.test(name)||name.endsWith(".lock")}function collectFiles(root){const files=[];function visit(directory){const entries=readdirSync(directory,{withFileTypes:!0}).sort((a,b)=>a.name.localeCompare(b.name));for(const entry of entries){const fullPath=resolve(directory,entry.name),projectPath=normalizePath(relative(root,fullPath));if(isExcluded(projectPath))continue;if(entry.isDirectory())visit(fullPath);else if(entry.isFile()&&!lstatSync(fullPath).isSymbolicLink())files.push(projectPath)}}visit(root);return files.sort((a,b)=>a.localeCompare(b))}function readPackageSummary(root){const packagePath=resolve(root,"package.json");if(!existsSync(packagePath))return{name:null,version:null,scripts:[],dependencies:[]};try{const manifest=JSON.parse(readFileSync(packagePath,"utf8")),dependencies=[...Object.keys(manifest.dependencies||{}),...Object.keys(manifest.devDependencies||{}),...Object.keys(manifest.peerDependencies||{})];return{name:typeof manifest.name==="string"?manifest.name:null,version:typeof manifest.version==="string"?manifest.version:null,scripts:Object.keys(manifest.scripts||{}).sort().slice(0,25),dependencies:[...new Set(dependencies)].sort().slice(0,30)}}catch{return{name:null,version:null,scripts:[],dependencies:[]}}}function filePriority(path){if(/^(?:AGENTS|CLAUDE)\.md$|^\.github\/copilot-instructions\.md$/.test(path))return 0;if(path==="package.json"||path==="app/Routes.ts"||path==="app/Commands.ts")return 1;if(/^(?:app|routes|config)\//.test(path))return 2;if(/^(?:resources|database|tests)\//.test(path))return 3;if(/^docs\//.test(path))return 4;if(/^storage\/framework\/defaults\//.test(path))return 5;return 6}function representativeFiles(files,maxFiles){return[...files].sort((a,b)=>filePriority(a)-filePriority(b)||a.localeCompare(b)).slice(0,maxFiles).sort((a,b)=>a.localeCompare(b))}function surfacePaths(files,prefixes){return files.filter((file)=>prefixes.some((prefix)=>prefix.endsWith("/")?file.startsWith(prefix):file===prefix)).slice(0,4)}function renderContext(context){return["Stacks AI Project Context v1","",`Project: ${context.project.name||"unnamed"}${context.project.version?`@${context.project.version}`:""}`,"Architecture: Model-View-Action",`Override rule: ${context.architecture.overrideRule}`,`Authoring order: ${context.architecture.authoringOrder.join(" -> ")}`,"","Authoring principles:",...context.architecture.principles.map((principle)=>`- ${principle}`),"","Instruction files:",...context.instructionFiles.length?context.instructionFiles.map((file)=>`- ${file}`):["- none detected"],"","Available surfaces:",...context.surfaces.flatMap((surface)=>[`- ${surface.id}: ${surface.purpose}`,...surface.paths.map((path)=>`  - ${path}`)]),"",`Scripts: ${context.project.scripts.join(", ")||"none detected"}`,`Dependencies: ${context.project.dependencies.join(", ")||"none detected"}`,"","Representative files:",...context.representativeFiles.map((file)=>`- ${file}`)].join(`
+`)}function fitToBudget(text,maxChars){if(text.length<=maxChars)return{text,truncated:!1};const marker=`
+[context truncated by character budget]`;if(maxChars<=marker.length)return{text:marker.slice(0,maxChars),truncated:!0};const available=maxChars-marker.length,prefix=text.slice(0,available),lastLine=prefix.lastIndexOf(`
+`);return{text:`${prefix.slice(0,lastLine>0?lastLine:available)}${marker}`,truncated:!0}}function unstructuredBaseline(root,files){const readmePath=resolve(root,"README.md"),packagePath=resolve(root,"package.json"),readme=existsSync(readmePath)?readFileSync(readmePath,"utf8").slice(0,2000):"",packageJson=existsSync(packagePath)?readFileSync(packagePath,"utf8"):"";return["Repository Structure:",files.slice(0,50).join(`
+`),readme?`README.md (excerpt):
+${readme}`:"",packageJson?`package.json:
+${packageJson}`:""].filter(Boolean).join(`
 
-`);
-}
-export function buildProjectContext(repoPath, options = {}) {
-  const root = resolve(repoPath), maxChars = options.maxChars ?? DEFAULT_MAX_CHARS, maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES, model = options.model || "gpt-4o";
-  if (!Number.isInteger(maxChars) || maxChars < 256)
-    throw Error("maxChars must be an integer of at least 256");
-  if (!Number.isInteger(maxFiles) || maxFiles < 1)
-    throw Error("maxFiles must be a positive integer");
-  const files = collectFiles(root), included = representativeFiles(files, maxFiles), context = {
-    schema: STACKS_PROJECT_CONTEXT_SCHEMA,
-    schemaVersion: "1.0.0",
-    framework: "stacks",
-    architecture: {
-      pattern: "Model-View-Action",
-      overrideRule: "Application files under app/ override matching framework defaults; do not edit defaults for application customization.",
-      authoringOrder: ["model", "migration", "action", "route", "test"],
-      principles: [
-        "Prefer conventional paths and framework generators over bespoke glue code.",
-        "Declare domain shape once and derive validation, migrations, API surfaces, and types where supported.",
-        "Keep Actions transport-independent and make unsupported drivers fail loudly.",
-        "Read repository instruction files before changing source."
-      ]
-    },
-    project: readPackageSummary(root),
-    instructionFiles: files.filter((file) => /(?:^|\/)(?:AGENTS|CLAUDE)\.md$|^\.github\/copilot-instructions\.md$/.test(file)),
-    surfaces: surfaceDefinitions.map((surface) => ({ id: surface.id, purpose: surface.purpose, paths: surfacePaths(files, surface.prefixes) })).filter((surface) => surface.paths.length > 0),
-    representativeFiles: included,
-    exclusions: [
-      "dependency, build, cache, coverage, temporary, and vendor directories",
-      "lockfiles",
-      "environment, credential, private-key, and secret files"
-    ]
-  }, fitted = fitToBudget(renderContext(context), maxChars), baseline = unstructuredBaseline(root, files), outputTokens = estimateTokens(fitted.text, model), baselineTokens = estimateTokens(baseline, model), reduction = baselineTokens > 0 ? Math.round((1 - outputTokens / baselineTokens) * 1000) / 10 : null;
-  return {
-    context,
-    text: fitted.text,
-    metrics: {
-      candidateFiles: files.length,
-      includedFiles: included.length,
-      maxCharacters: maxChars,
-      outputCharacters: fitted.text.length,
-      estimatedTokens: outputTokens,
-      model,
-      truncated: fitted.truncated,
-      baselineMethod: "sorted-first-50-paths+readme-2000+package-json",
-      baselineCharacters: baseline.length,
-      baselineEstimatedTokens: baselineTokens,
-      estimatedTokenReductionPercent: reduction,
-      tokenEstimateIsHeuristic: !0
-    }
-  };
-}
+`)}export function buildProjectContext(repoPath,options={}){const root=resolve(repoPath),maxChars=options.maxChars??DEFAULT_MAX_CHARS,maxFiles=options.maxFiles??DEFAULT_MAX_FILES,model=options.model||"gpt-4o";if(!Number.isInteger(maxChars)||maxChars<256)throw Error("maxChars must be an integer of at least 256");if(!Number.isInteger(maxFiles)||maxFiles<1)throw Error("maxFiles must be a positive integer");const files=collectFiles(root),included=representativeFiles(files,maxFiles),context={schema:STACKS_PROJECT_CONTEXT_SCHEMA,schemaVersion:"1.0.0",framework:"stacks",architecture:{pattern:"Model-View-Action",overrideRule:"Application files under app/ override matching framework defaults; do not edit defaults for application customization.",authoringOrder:["model","migration","action","route","test"],principles:["Prefer conventional paths and framework generators over bespoke glue code.","Declare domain shape once and derive validation, migrations, API surfaces, and types where supported.","Keep Actions transport-independent and make unsupported drivers fail loudly.","Read repository instruction files before changing source."]},project:readPackageSummary(root),instructionFiles:files.filter((file)=>/(?:^|\/)(?:AGENTS|CLAUDE)\.md$|^\.github\/copilot-instructions\.md$/.test(file)),surfaces:surfaceDefinitions.map((surface)=>({id:surface.id,purpose:surface.purpose,paths:surfacePaths(files,surface.prefixes)})).filter((surface)=>surface.paths.length>0),representativeFiles:included,exclusions:["dependency, build, cache, coverage, temporary, and vendor directories","lockfiles","environment, credential, private-key, and secret files"]},fitted=fitToBudget(renderContext(context),maxChars),baseline=unstructuredBaseline(root,files),outputTokens=estimateTokens(fitted.text,model),baselineTokens=estimateTokens(baseline,model),reduction=baselineTokens>0?Math.round((1-outputTokens/baselineTokens)*1000)/10:null;return{context,text:fitted.text,metrics:{candidateFiles:files.length,includedFiles:included.length,maxCharacters:maxChars,outputCharacters:fitted.text.length,estimatedTokens:outputTokens,model,truncated:fitted.truncated,baselineMethod:"sorted-first-50-paths+readme-2000+package-json",baselineCharacters:baseline.length,baselineEstimatedTokens:baselineTokens,estimatedTokenReductionPercent:reduction,tokenEstimateIsHeuristic:!0}}}