@lssm/bundle.contractspec-workspace 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/services/agent-guide/agent-guide-service.js

@@ -1 +1,148 @@
-import{a as e,o as t,s as n}from"../../libs/contracts/dist/llm/exporters.js";import{s as r}from"../../libs/contracts/dist/llm/prompts.js";import"../../libs/contracts/dist/llm/index.js";import{getAgentAdapter as i,listAgentTypes as a}from"./adapters/index.js";const o={defaultAgent:`generic-mcp`,verbose:!1};var s=class{config;constructor(e={}){this.config={...o,...e}}generateGuide(t,n={}){let a=i(n.agent??this.config.defaultAgent),o=r(t,{projectRoot:this.config.projectRoot,existingFiles:n.targetPath?[n.targetPath]:void 0});return{plan:o,prompt:a.formatPlan(o),markdown:e(t)}}generateFeatureGuide(e,t,a={}){let o=i(a.agent??this.config.defaultAgent),s=e.operations?.[0],c=s?t.specs?.getSpec(s.name,s.version):void 0,l;c?(l=r(c,{projectRoot:this.config.projectRoot}),l.target={type:`feature`,name:e.meta.key,version:1},l.context.goal=e.meta.description??l.context.goal):l={target:{type:`feature`,name:e.meta.key,version:1},context:{goal:e.meta.description??`Implement feature ${e.meta.key}`,description:e.meta.title??e.meta.key,background:``},specMarkdown:n(e,t),fileStructure:[],steps:[{order:1,title:`Implement Feature`,description:`Implement the ${e.meta.key} feature`,acceptanceCriteria:[]}],constraints:{policy:[],security:[],pii:[]},verificationChecklist:[]},l.specMarkdown=n(e,t,{format:`full`,includeRelatedSpecs:!0,includeRelatedEvents:!0,includeRelatedPresentations:!0}),e.operations?.length&&(l.steps=e.operations.map((e,t)=>({order:t+1,title:`Implement ${e.name}`,description:`Implement operation ${e.name}.v${e.version}`,acceptanceCriteria:[`Operation ${e.name} works as specified`]})));let u=o.formatPlan(l),d=n(e,t);return{plan:l,prompt:u,markdown:d}}generateAgentConfig(e,t){return i(t??this.config.defaultAgent).generateConfig?.(e)}exportForAgent(e,n,r=`implement`,i){return t(e,{taskType:r,existingCode:i})}listAgentTypes(){return a()}getDefaultAgent(){return this.config.defaultAgent}configure(e){this.config={...this.config,...e}}};function c(e){return new s(e)}const l=new s;export{s as AgentGuideService,l as agentGuideService,c as createAgentGuideService};
+import { featureToMarkdown, specToAgentPrompt, specToFullMarkdown } from "../../libs/contracts/dist/llm/exporters.js";
+import { generateImplementationPlan } from "../../libs/contracts/dist/llm/prompts.js";
+import "../../libs/contracts/dist/llm/index.js";
+import { getAgentAdapter, listAgentTypes } from "./adapters/index.js";
+
+//#region src/services/agent-guide/agent-guide-service.ts
+const DEFAULT_CONFIG = {
+	defaultAgent: "generic-mcp",
+	verbose: false
+};
+/**
+* Agent Guide Service
+*
+* Main service for generating implementation guidance for AI coding agents.
+*/
+var AgentGuideService = class {
+	config;
+	constructor(config = {}) {
+		this.config = {
+			...DEFAULT_CONFIG,
+			...config
+		};
+	}
+	/**
+	* Generate an implementation guide for a spec.
+	*/
+	generateGuide(spec, options = {}) {
+		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
+		const plan = generateImplementationPlan(spec, {
+			projectRoot: this.config.projectRoot,
+			existingFiles: options.targetPath ? [options.targetPath] : void 0
+		});
+		return {
+			plan,
+			prompt: adapter.formatPlan(plan),
+			markdown: specToFullMarkdown(spec)
+		};
+	}
+	/**
+	* Generate a guide for a feature (includes all related specs).
+	*/
+	generateFeatureGuide(feature, deps, options = {}) {
+		const adapter = getAgentAdapter(options.agent ?? this.config.defaultAgent);
+		const firstOp = feature.operations?.[0];
+		const spec = firstOp ? deps.specs?.getSpec(firstOp.name, firstOp.version) : void 0;
+		let plan;
+		if (spec) {
+			plan = generateImplementationPlan(spec, { projectRoot: this.config.projectRoot });
+			plan.target = {
+				type: "feature",
+				name: feature.meta.key,
+				version: 1
+			};
+			plan.context.goal = feature.meta.description ?? plan.context.goal;
+		} else plan = {
+			target: {
+				type: "feature",
+				name: feature.meta.key,
+				version: 1
+			},
+			context: {
+				goal: feature.meta.description ?? `Implement feature ${feature.meta.key}`,
+				description: feature.meta.title ?? feature.meta.key,
+				background: ""
+			},
+			specMarkdown: featureToMarkdown(feature, deps),
+			fileStructure: [],
+			steps: [{
+				order: 1,
+				title: "Implement Feature",
+				description: `Implement the ${feature.meta.key} feature`,
+				acceptanceCriteria: []
+			}],
+			constraints: {
+				policy: [],
+				security: [],
+				pii: []
+			},
+			verificationChecklist: []
+		};
+		plan.specMarkdown = featureToMarkdown(feature, deps, {
+			format: "full",
+			includeRelatedSpecs: true,
+			includeRelatedEvents: true,
+			includeRelatedPresentations: true
+		});
+		if (feature.operations?.length) plan.steps = feature.operations.map((op, idx) => ({
+			order: idx + 1,
+			title: `Implement ${op.name}`,
+			description: `Implement operation ${op.name}.v${op.version}`,
+			acceptanceCriteria: [`Operation ${op.name} works as specified`]
+		}));
+		const prompt = adapter.formatPlan(plan);
+		const markdown = featureToMarkdown(feature, deps);
+		return {
+			plan,
+			prompt,
+			markdown
+		};
+	}
+	/**
+	* Generate agent-specific configuration (e.g., cursor rules).
+	*/
+	generateAgentConfig(spec, agent) {
+		return getAgentAdapter(agent ?? this.config.defaultAgent).generateConfig?.(spec);
+	}
+	/**
+	* Export a spec in a specific format for an agent.
+	*/
+	exportForAgent(spec, agent, taskType = "implement", existingCode) {
+		return specToAgentPrompt(spec, {
+			taskType,
+			existingCode
+		});
+	}
+	/**
+	* List available agent types.
+	*/
+	listAgentTypes() {
+		return listAgentTypes();
+	}
+	/**
+	* Get the default agent type.
+	*/
+	getDefaultAgent() {
+		return this.config.defaultAgent;
+	}
+	/**
+	* Update configuration.
+	*/
+	configure(config) {
+		this.config = {
+			...this.config,
+			...config
+		};
+	}
+};
+/**
+* Create a new AgentGuideService instance.
+*/
+function createAgentGuideService(config) {
+	return new AgentGuideService(config);
+}
+/** Default singleton instance */
+const agentGuideService = new AgentGuideService();
+
+//#endregion
+export { AgentGuideService, agentGuideService, createAgentGuideService };

package/dist/services/agent-guide/index.js

@@ -1 +1,5 @@
-import{ClaudeCodeAdapter as e,claudeCodeAdapter as t}from"./adapters/claude-code.js";import{CursorCLIAdapter as n,cursorCLIAdapter as r}from"./adapters/cursor-cli.js";import{GenericMCPAdapter as i,genericMCPAdapter as a}from"./adapters/generic-mcp.js";import{agentAdapters as o,getAgentAdapter as s,listAgentTypes as c}from"./adapters/index.js";import{AgentGuideService as l,agentGuideService as u,createAgentGuideService as d}from"./agent-guide-service.js";
+import { ClaudeCodeAdapter, claudeCodeAdapter } from "./adapters/claude-code.js";
+import { CursorCLIAdapter, cursorCLIAdapter } from "./adapters/cursor-cli.js";
+import { GenericMCPAdapter, genericMCPAdapter } from "./adapters/generic-mcp.js";
+import { agentAdapters, getAgentAdapter, listAgentTypes } from "./adapters/index.js";
+import { AgentGuideService, agentGuideService, createAgentGuideService } from "./agent-guide-service.js";

package/dist/services/build.js

@@ -1 +1,140 @@
-import{e,t}from"../modules/contractspec-workspace/dist/analysis/spec-scan.js";import{a as n,i as r,r as i}from"../modules/contractspec-workspace/dist/templates/handler.js";async function a(n,r,i,a={}){let{fs:c,logger:l}=r,{targets:u=s(n),outputDir:d=i.outputDir,overwrite:f=!1,dryRun:p=!1}=a,m=await c.readFile(n),h=t(m,n),g=e(n);l.info(`Building from spec: ${n}`,{specType:g});let _=[];for(let e of u)try{let t=await o(e,n,m,h,g,{fs:c,logger:l},d,f,p);_.push(t)}catch(t){_.push({target:e,outputPath:``,success:!1,error:t instanceof Error?t.message:String(t)})}return{specPath:n,specInfo:h,results:_}}async function o(e,t,a,o,s,l,u,d,f){let{fs:p,logger:m}=l,h,g;switch(e){case`handler`:{if(s!==`operation`)return{target:e,outputPath:``,success:!1,skipped:!0,error:`Handler generation only supported for operation specs (got ${s})`};let n=o.kind===`command`||o.kind===`query`?o.kind:`command`;h=i(o.name??`unknown`,n),g=c(t,u,`handlers`,o.name??`unknown`,`.handler.ts`,l.fs);break}case`component`:if(s!==`presentation`)return{target:e,outputPath:``,success:!1,skipped:!0,error:`Component generation only supported for presentation specs (got ${s})`};h=r(o.name??`unknown`,o.description??``),g=c(t,u,`components`,o.name??`unknown`,`.tsx`,l.fs);break;case`test`:{let e=s===`operation`?`handler`:`component`;h=n(o.name??`unknown`,e),g=c(t,u,`__tests__`,o.name??`unknown`,`.test.ts`,l.fs);break}default:return{target:e,outputPath:``,success:!1,error:`Unknown target: ${e}`}}if(await p.exists(g)&&!d)return{target:e,outputPath:g,success:!1,skipped:!0,error:`File already exists (use overwrite option)`};if(f)return m.info(`[dry-run] Would write: ${g}`),{target:e,outputPath:g,success:!0};let _=p.dirname(g);return await p.mkdir(_),await p.writeFile(g,h),m.info(`Generated: ${g}`),{target:e,outputPath:g,success:!0}}function s(t){switch(e(t)){case`operation`:return[`handler`];case`presentation`:return[`component`];default:return[]}}function c(e,t,n,r,i,a){let o=l(r.split(`.`).pop()??`unknown`),s;return s=t.startsWith(`.`)?a.resolve(a.dirname(e),`..`,t,n):a.resolve(t,n),a.join(s,`${o}${i}`)}function l(e){return e.replace(/\./g,`-`).replace(/([a-z])([A-Z])/g,`$1-$2`).toLowerCase()}export{a as buildSpec};
+import { inferSpecTypeFromFilePath, scanSpecSource } from "../modules/contractspec-workspace/dist/analysis/spec-scan.js";
+import { generateComponentTemplate, generateHandlerTemplate, generateTestTemplate } from "../modules/contractspec-workspace/dist/templates/handler.js";
+
+//#region src/services/build.ts
+/**
+* Build/scaffold service for generating implementation files from specs.
+*
+* Uses templates from @lssm/module.contractspec-workspace to generate
+* handler, component, and test skeletons without requiring AI.
+*/
+/**
+* Build implementation files from a spec.
+*/
+async function buildSpec(specPath, adapters, config, options = {}) {
+	const { fs, logger } = adapters;
+	const { targets = detectDefaultTargets(specPath), outputDir = config.outputDir, overwrite = false, dryRun = false } = options;
+	const specCode = await fs.readFile(specPath);
+	const specInfo = scanSpecSource(specCode, specPath);
+	const specType = inferSpecTypeFromFilePath(specPath);
+	logger.info(`Building from spec: ${specPath}`, { specType });
+	const results = [];
+	for (const target of targets) try {
+		const result = await buildTarget(target, specPath, specCode, specInfo, specType, {
+			fs,
+			logger
+		}, outputDir, overwrite, dryRun);
+		results.push(result);
+	} catch (error) {
+		results.push({
+			target,
+			outputPath: "",
+			success: false,
+			error: error instanceof Error ? error.message : String(error)
+		});
+	}
+	return {
+		specPath,
+		specInfo,
+		results
+	};
+}
+/**
+* Build a single target from a spec.
+*/
+async function buildTarget(target, specPath, _specCode, specInfo, specType, adapters, outputDir, overwrite, dryRun) {
+	const { fs, logger } = adapters;
+	let code;
+	let outputPath;
+	switch (target) {
+		case "handler": {
+			if (specType !== "operation") return {
+				target,
+				outputPath: "",
+				success: false,
+				skipped: true,
+				error: `Handler generation only supported for operation specs (got ${specType})`
+			};
+			const kind = specInfo.kind === "command" || specInfo.kind === "query" ? specInfo.kind : "command";
+			code = generateHandlerTemplate(specInfo.name ?? "unknown", kind);
+			outputPath = resolveOutputPath(specPath, outputDir, "handlers", specInfo.name ?? "unknown", ".handler.ts", adapters.fs);
+			break;
+		}
+		case "component":
+			if (specType !== "presentation") return {
+				target,
+				outputPath: "",
+				success: false,
+				skipped: true,
+				error: `Component generation only supported for presentation specs (got ${specType})`
+			};
+			code = generateComponentTemplate(specInfo.name ?? "unknown", specInfo.description ?? "");
+			outputPath = resolveOutputPath(specPath, outputDir, "components", specInfo.name ?? "unknown", ".tsx", adapters.fs);
+			break;
+		case "test": {
+			const testType = specType === "operation" ? "handler" : "component";
+			code = generateTestTemplate(specInfo.name ?? "unknown", testType);
+			outputPath = resolveOutputPath(specPath, outputDir, "__tests__", specInfo.name ?? "unknown", ".test.ts", adapters.fs);
+			break;
+		}
+		default: return {
+			target,
+			outputPath: "",
+			success: false,
+			error: `Unknown target: ${target}`
+		};
+	}
+	if (await fs.exists(outputPath) && !overwrite) return {
+		target,
+		outputPath,
+		success: false,
+		skipped: true,
+		error: "File already exists (use overwrite option)"
+	};
+	if (dryRun) {
+		logger.info(`[dry-run] Would write: ${outputPath}`);
+		return {
+			target,
+			outputPath,
+			success: true
+		};
+	}
+	const dirPath = fs.dirname(outputPath);
+	await fs.mkdir(dirPath);
+	await fs.writeFile(outputPath, code);
+	logger.info(`Generated: ${outputPath}`);
+	return {
+		target,
+		outputPath,
+		success: true
+	};
+}
+/**
+* Detect default targets based on spec type.
+*/
+function detectDefaultTargets(specPath) {
+	switch (inferSpecTypeFromFilePath(specPath)) {
+		case "operation": return ["handler"];
+		case "presentation": return ["component"];
+		default: return [];
+	}
+}
+/**
+* Resolve output path for generated file.
+*/
+function resolveOutputPath(specPath, outputDir, subdir, specName, extension, fs) {
+	const sanitizedName = toKebabCase(specName.split(".").pop() ?? "unknown");
+	let baseDir;
+	if (outputDir.startsWith(".")) baseDir = fs.resolve(fs.dirname(specPath), "..", outputDir, subdir);
+	else baseDir = fs.resolve(outputDir, subdir);
+	return fs.join(baseDir, `${sanitizedName}${extension}`);
+}
+/**
+* Convert string to kebab-case.
+*/
+function toKebabCase(str) {
+	return str.replace(/\./g, "-").replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+//#endregion
+export { buildSpec };