@getarbiter/cli 0.5.0

package/dist/generators/check-all.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{resolveEffectiveThresholds}from"../config/thresholds.js";import{resolveCollaborationMode}from"../config/collaboration-mode-defaults.js";import{isSubtreeFrontendLane}from"../detectors/lanes.js";import{levelAtLeast,LEVEL_ORDER}from"../config/levels.js";import{parse as parseYaml}from"yaml";const VALID_LEVELS=new Set(["L1","L2","L3"]),VALID_KINDS=new Set(["check","warn","tool","inline"]);function deriveGateRegistryRenderData(data){const fe=data.frontend?.framework??"react",feGlob=fe==="vue"?"src/**/*.{ts,vue}":fe==="svelte"?"src/**/*.{ts,svelte}":"src/**/*.{ts,tsx,jsx}",govLevel=data.governanceLevel,isL3Plus=typeof govLevel=="string"&&LEVEL_ORDER.includes(govLevel)&&levelAtLeast(govLevel,"L3");return{...data,packageManager:data.packageManager??"npm",ratchetFlag:isL3Plus?"--require-improvement":"--gate",_feGlob:feGlob}}function parseGateRegistryYaml(rendered){let parsed;try{parsed=parseYaml(rendered)}catch(err){throw new Error(`gate registry: invalid YAML in gate-registry.yml.ejs \u2014 ${err instanceof Error?err.message:String(err)}`,{cause:err})}const raw=parsed?.gates;if(!Array.isArray(raw))throw new Error('gate registry: missing "gates" array');return raw}function validateGateEntryShape(entry,seen){const id=entry.id;if(typeof id!="string"||id.length===0)throw new Error("gate registry: every gate needs a string id");if(seen.has(id))throw new Error(`gate registry: duplicate gate id "${id}"`);seen.add(id);const level=entry.level;if(typeof level!="string"||!VALID_LEVELS.has(level))throw new Error(`gate registry: gate "${id}" has invalid level ${String(level)}`);const kind=entry.kind;if(typeof kind!="string"||!VALID_KINDS.has(kind))throw new Error(`gate registry: gate "${id}" has invalid kind ${String(kind)}`);if(kind!=="inline"&&!Array.isArray(entry.cmd))throw new Error(`gate registry: non-inline gate "${id}" needs a cmd array`);if(kind==="inline"&&entry.cmd!==void 0)throw new Error(`gate registry: inline gate "${id}" must not declare cmd (bodies live in the template)`);return{id,level,kind}}function flattenGateCmd(entry){const rawCmd=entry.cmd;if(rawCmd!==void 0)return[String(rawCmd[0]),...(rawCmd[1]??[]).map(String)]}function normalizeGateEntry(entry,seen){const{id,level,kind}=validateGateEntryShape(entry,seen),flatCmd=flattenGateCmd(entry);return{id,name:String(entry.name),level,kind,...flatCmd!==void 0?{cmd:flatCmd}:{},...typeof entry.language=="string"?{language:entry.language}:{},...typeof entry.emitIf=="string"?{emitIf:entry.emitIf}:{},...typeof entry.condition=="string"?{condition:entry.condition}:{},...typeof entry.else=="string"?{else:entry.else}:{},...entry.soft===!0?{soft:!0}:{},...typeof entry.promotes_to=="string"?{promotes_to:entry.promotes_to}:{},...entry.audit===!0?{audit:!0}:{}}}export function validatePromotions(entries){const ids=new Set(entries.map(e=>e.id));for(const entry of entries)if(entry.promotes_to!==void 0){if(!ids.has(entry.promotes_to))throw new Error(`gate registry: gate "${entry.id}" promotes_to unknown gate id "${entry.promotes_to}"`);if(entry.condition!==void 0||entry.else!==void 0)throw new Error(`gate registry: gate "${entry.id}" declares promotes_to and a runtime condition/else \u2014 a false condition would suppress both gates silently`);if(entry.kind==="inline")throw new Error(`gate registry: gate "${entry.id}" declares promotes_to and kind: inline \u2014 an inline gate with no matching template branch would suppress both gates silently`)}}export function loadGateRegistry(data){const registryData=deriveGateRegistryRenderData(data),rendered=renderTemplate("scripts/gate-registry.yml.ejs",registryData),raw=parseGateRegistryYaml(rendered),seen=new Set,entries=raw.map(entry=>normalizeGateEntry(entry,seen));return validatePromotions(entries),entries}function binarySizeBudget(archetype){return archetype==="cli"?10*1048576:archetype==="embedded"?5*1048576:0}function emitCoverageGate(base,data,opts){if(!(data.language==="typescript"&&data.enableDebtGates&&data.coverageEnabled))return[];const coverageGatePath=resolvedPath(base,"scripts","lib","coverage-gate.mjs");return[writeFile(coverageGatePath,renderTemplate("scripts/lib/coverage-gate.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}function emitTemplateFile(base,relPath,template,data,opts){return writeFile(resolvedPath(base,...relPath),renderTemplate(template,data),{skipIfExists:!0,dryRun:opts.dryRun})}const UNCONDITIONAL_EMISSIONS=[{rel:["scripts","check-all.mjs"],tpl:"scripts/check-all.mjs.ejs"},{rel:["scripts","test-gate-layering.mjs"],tpl:"scripts/test-gate-layering.mjs.ejs"},{rel:["scripts","optional-emissions.json"],tpl:"scripts/optional-emissions.json.ejs"},{rel:["scripts","lib","run-helpers.mjs"],tpl:"scripts/lib/run-helpers.mjs.ejs"},{rel:["scripts","lib","gate-evidence.mjs"],tpl:"scripts/lib/gate-evidence.mjs.ejs"},{rel:["scripts","lib","gate-mutex.mjs"],tpl:"scripts/lib/gate-mutex.mjs.ejs"},{rel:["scripts","lib","evidence-binding.mjs"],tpl:"scripts/lib/evidence-binding.mjs.ejs"},{rel:["scripts","check-collab-mode-wired.mjs"],tpl:"scripts/check-collab-mode-wired.mjs.ejs"},{rel:["scripts","check-hook-routing.mjs"],tpl:"scripts/check-hook-routing.mjs.ejs"},{rel:["scripts","check-emission-parity.mjs"],tpl:"scripts/check-emission-parity.mjs.ejs"},{rel:["scripts","check-constraint-scan.mjs"],tpl:"scripts/check-constraint-scan.mjs.ejs"},{rel:["scripts","constraint-map.json"],tpl:"scripts/constraint-map.json.ejs"},{rel:["scripts","check-no-tracked-artifacts.mjs"],tpl:"scripts/check-no-tracked-artifacts.mjs.ejs"},{rel:["scripts","check-image-pins.mjs"],tpl:"scripts/check-image-pins.mjs.ejs"},{rel:["scripts","lib","e2e-reliability.mjs"],tpl:"scripts/lib/e2e-reliability.mjs.ejs"},{rel:["scripts","check-e2e-quarantine.mjs"],tpl:"scripts/check-e2e-quarantine.mjs.ejs"},{rel:["scripts","check-tdd-evidence.mjs"],tpl:"scripts/check-tdd-evidence.mjs.ejs"},{rel:["scripts","check-tabletop-evidence.mjs"],tpl:"scripts/check-tabletop-evidence.mjs.ejs"},{rel:["schemas","tabletop-evidence.schema.json"],tpl:"schemas/tabletop-evidence.schema.json.ejs"},{rel:["scripts","check-sources.mjs"],tpl:"scripts/check-sources.mjs.ejs"},{rel:["schemas","source-record.schema.json"],tpl:"schemas/source-record.schema.json.ejs"},{rel:["scripts","check-use-cases.mjs"],tpl:"scripts/check-use-cases.mjs.ejs"},{rel:["schemas","use-case.schema.json"],tpl:"schemas/use-case.schema.json.ejs"},{rel:["scripts","check-milestones.mjs"],tpl:"scripts/check-milestones.mjs.ejs"},{rel:["schemas","milestone.schema.json"],tpl:"schemas/milestone.schema.json.ejs"},{rel:["scripts","check-todo-max-age.mjs"],tpl:"scripts/check-todo-max-age.mjs.ejs"},{rel:["scripts","check-test-pyramid.mjs"],tpl:"scripts/check-test-pyramid.mjs.ejs"},{rel:["scripts","verify-module-coverage.mjs"],tpl:"scripts/verify-module-coverage.mjs.ejs"},{rel:["scripts","verify-mutation-baseline.mjs"],tpl:"scripts/verify-mutation-baseline.mjs.ejs"},{rel:["scripts","check-api-e2e.mjs"],tpl:"scripts/check-api-e2e.mjs.ejs"},{rel:["scripts","check-render-smoke.mjs"],tpl:"scripts/check-render-smoke.mjs.ejs"},{rel:["scripts","check-smoke-journeys.mjs"],tpl:"scripts/check-smoke-journeys.mjs.ejs"},{rel:["scripts","check-e2e-escalation.mjs"],tpl:"scripts/check-e2e-escalation.mjs.ejs"},{rel:["scripts","check-m16-handoff.mjs"],tpl:"scripts/check-m16-handoff.mjs.ejs"},{rel:["scripts","lib","glob-walk.mjs"],tpl:"scripts/lib/glob-walk.mjs.ejs"},{rel:["scripts","issue-readiness.mjs"],tpl:"scripts/issue-readiness.mjs.ejs"},{rel:["scripts","check-acceptance.mjs"],tpl:"scripts/check-acceptance.mjs.ejs"},{rel:["scripts","rework-log.mjs"],tpl:"scripts/rework-log.mjs.ejs"},{rel:["scripts","lib","acceptance-criteria.mjs"],tpl:"scripts/lib/acceptance-criteria.mjs.ejs"},{rel:["scripts","check-doc-set.mjs"],tpl:"scripts/check-doc-set.mjs.ejs"},{rel:["scripts","check-arc42-slots.mjs"],tpl:"scripts/check-arc42-slots.mjs.ejs"},{rel:["scripts","check-doc-freshness.mjs"],tpl:"scripts/check-doc-freshness.mjs.ejs"},{rel:["scripts","check-anti-fake-green.mjs"],tpl:"scripts/check-anti-fake-green.mjs.ejs"},{rel:["scripts","check-decision-registry.mjs"],tpl:"scripts/check-decision-registry.mjs.ejs"},{rel:["scripts","check-muted-test.mjs"],tpl:"scripts/check-muted-test.mjs.ejs"},{rel:["muted-tests-baseline.json"],tpl:"scripts/muted-tests-baseline.json.ejs"},{rel:["scripts","check-skip-critical-e2e.mjs"],tpl:"scripts/check-skip-critical-e2e.mjs.ejs"},{rel:["scripts","check-no-stub-redirects.mjs"],tpl:"scripts/check-no-stub-redirects.mjs.ejs"},{rel:["scripts","check-grace-window.mjs"],tpl:"scripts/check-grace-window.mjs.ejs"},{rel:["scripts","check-assertion-delta.mjs"],tpl:"scripts/check-assertion-delta.mjs.ejs"},{rel:["scripts","check-safety-adopt-ratchet.mjs"],tpl:"scripts/check-safety-adopt-ratchet.mjs.ejs"},{rel:["scripts","check-touched-vs-manifest.mjs"],tpl:"scripts/check-touched-vs-manifest.mjs.ejs"},{rel:["scripts","record-agent-return.mjs"],tpl:"scripts/record-agent-return.mjs.ejs"},{rel:["scripts","lib","gate-args.mjs"],tpl:"scripts/lib/gate-args.mjs.ejs"},{rel:["scripts","lib","agent-return-validate.mjs"],tpl:"scripts/lib/agent-return-validate.mjs.ejs"},{rel:["schemas","agent-return.schema.json"],tpl:"scripts/schemas/agent-return.schema.json.ejs"},{rel:["schemas","agent-return-external.schema.json"],tpl:"scripts/schemas/agent-return-external.schema.json"},{rel:["scripts","check-cross-model-review.mjs"],tpl:"scripts/check-cross-model-review.mjs.ejs"},{rel:["schemas","cross-model-dispatch.schema.json"],tpl:"scripts/schemas/cross-model-dispatch.schema.json"},{rel:["scripts","gh-cleanup-expired-artifacts.mjs"],tpl:"scripts/gh-cleanup-expired-artifacts.mjs.ejs"}],DEBT_GATED_EMISSIONS=[{rel:["scripts","check-agent-return.mjs"],tpl:"scripts/check-agent-return.mjs.ejs"},{rel:["scripts","check-review-completion.mjs"],tpl:"scripts/check-review-completion.mjs.ejs"},{rel:["scripts","check-refutation-verdicts.mjs"],tpl:"scripts/check-refutation-verdicts.mjs.ejs"},{rel:["scripts","check-audit-dry-pass.mjs"],tpl:"scripts/check-audit-dry-pass.mjs.ejs"},{rel:["scripts","check-handoff-doc.mjs"],tpl:"scripts/check-handoff-doc.mjs.ejs"}];function emitUnconditional(base,data,opts){return UNCONDITIONAL_EMISSIONS.map(({rel,tpl})=>emitTemplateFile(base,rel,tpl,data,opts))}function emitDebtGated(base,data,opts){return data.enableDebtGates!==!0?[]:DEBT_GATED_EMISSIONS.map(({rel,tpl})=>emitTemplateFile(base,rel,tpl,data,opts))}const EXTENDED_GATED_EMISSIONS=[{rel:["scripts","check-reuse-registry.mjs"],tpl:"scripts/check-reuse-registry.mjs.ejs"}];function emitExtendedGated(base,data,opts){return data.includeExtendedInvariants!==!0?[]:EXTENDED_GATED_EMISSIONS.map(({rel,tpl})=>emitTemplateFile(base,rel,tpl,data,opts))}export function generateCheckAll(config,opts={dryRun:!1}){const results=[],base=config.targetDir,effective=resolveEffectiveThresholds(config),data={...config,coverageThreshold:effective.lineCoverage,coverageEnabled:effective.coverageEnabled,mutationEnabled:effective.mutationEnabled,mutationThreshold:effective.mutationScore,binarySizeBytes:binarySizeBudget(config.archetype)};data.gates=loadGateRegistry(data),results.push(...emitUnconditional(base,data,opts)),results.push(...emitDebtGated(base,data,opts)),results.push(...emitExtendedGated(base,data,opts)),results.push(...emitCoverageGate(base,data,opts)),typeof config.governanceLevel=="string"&&LEVEL_ORDER.includes(config.governanceLevel)&&levelAtLeast(config.governanceLevel,"L3")&&results.push(writeFile(resolvedPath(base,"scripts","evidence-collect.mjs"),renderTemplate("scripts/evidence-collect.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const archetypesNeedingServer=new Set(["frontend-spa","backend-web-db"]);if(config.governanceLevel!=="L1"&&archetypesNeedingServer.has(config.archetype)){const ephemeralPath=resolvedPath(base,"scripts","lib","ephemeral-server.mjs");results.push(writeFile(ephemeralPath,renderTemplate("scripts/lib/ephemeral-server.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}))}return config.language==="rust"&&(results.push(writeFile(resolvedPath(base,"scripts","checks","check-rust-no-unwrap.mjs"),renderTemplate("scripts/checks/check-rust-no-unwrap.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"scripts","checks","check-rust-no-unsafe.mjs"),renderTemplate("scripts/checks/check-rust-no-unsafe.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}))),config.governanceLevel!=="L1"&&results.push(writeFile(resolvedPath(base,"scripts","check-docs.mjs"),renderTemplate("scripts/check-docs.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),resolveCollaborationMode(config)==="trunk-solo"&&results.push(writeFile(resolvedPath(base,"scripts","check-local-ci-parity.mjs"),renderTemplate("scripts/check-local-ci-parity.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(...emitDomainApiSurface(base,config,data,opts)),results.push(...emitOracleDiscrimination(base,config,data,opts)),results.push(...emitFrontendChecks(base,config,data,opts)),results.push(...emitConsumerAudit(base,config,data,opts)),{files:results}}function emitConsumerAudit(base,config,data,opts){return config.archetype!=="library"||config.language!=="typescript"||config.governanceLevel==="L1"?[]:[writeFile(resolvedPath(base,"scripts","check-consumer-audit.mjs"),renderTemplate("scripts/check-consumer-audit.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}function emitDomainApiSurface(base,config,data,opts){return config.hasPublicApi?[writeFile(resolvedPath(base,"scripts","check-domain-api-surface.mjs"),renderTemplate("scripts/check-domain-api-surface.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"domain-api-surface.json"),renderTemplate("scripts/domain-api-surface.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]:[]}function emitOracleDiscrimination(base,config,data,opts){return config.archetype==="frontend-spa"||config.archetype==="backend-web-db"?[writeFile(resolvedPath(base,"scripts","check-oracle-discrimination.mjs"),renderTemplate("scripts/check-oracle-discrimination.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"oracle-discrimination-baseline.json"),renderTemplate("scripts/oracle-discrimination-baseline.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]:[]}function emitFrontendChecks(base,config,data,opts){const out=[];return(config.archetype==="frontend-spa"||config.lanes.includes("frontend"))&&config.governanceLevel!=="L1"&&out.push(writeFile(resolvedPath(base,"scripts","check-fe-boundaries.mjs"),renderTemplate("scripts/check-fe-boundaries.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),isSubtreeFrontendLane(config)&&out.push(writeFile(resolvedPath(base,"scripts","check-frontend-lane.mjs"),renderTemplate("scripts/check-frontend-lane.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),out}

package/dist/generators/check-stack-conformity.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateStackConformity(config,opts={dryRun:!1}){const base=config.targetDir;return{files:[writeFile(resolvedPath(base,"scripts","check-stack-conformity.mjs"),renderTemplate("scripts/check-stack-conformity.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/ci-five-lane.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{chmodTranslated,resolvedPath,writeFile}from"../utils/fs.js";const SCRIPT_MODE=493;export function generateCiFiveLane(config,opts={dryRun:!1}){if(!config.enableFiveLaneCi||!(config.permitGitHub??config.useGitHub))return{files:[]};const data=config,githubDir=resolvedPath(config.targetDir,".github"),workflowsDir=join(githubDir,"workflows"),scriptsDir=join(githubDir,"scripts"),scriptPath=join(scriptsDir,"sticky-failure-issue.sh"),ciResult=writeFile(join(workflowsDir,"ci.yml"),renderTemplate("github/workflows/five-lane/ci.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),nightlyResult=writeFile(join(workflowsDir,"nightly.yml"),renderTemplate("github/workflows/five-lane/nightly.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),weeklyResult=writeFile(join(workflowsDir,"weekly.yml"),renderTemplate("github/workflows/five-lane/weekly.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),releaseResult=writeFile(join(workflowsDir,"release.yml"),renderTemplate("github/workflows/five-lane/release.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),scriptResult=writeFile(scriptPath,renderTemplate("github/scripts/sticky-failure-issue.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});return!opts.dryRun&&scriptResult.action!=="skipped"&&chmodTranslated(scriptPath,SCRIPT_MODE),{files:[ciResult,nightlyResult,weeklyResult,releaseResult,scriptResult]}}

package/dist/generators/ci-tier.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateCiTier(config,opts={dryRun:!1}){if(!githubGenerationIsEnabled(config))return{files:[]};const data=config,githubDir=resolvedPath(config.targetDir,".github"),workflowsDir=join(githubDir,"workflows"),actionsDir=join(githubDir,"actions"),files=[writeFile(join(workflowsDir,"_notify.yml"),renderTemplate("github/workflows/_notify.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(workflowsDir,"_label-sync.yml"),renderTemplate("github/workflows/_label-sync.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(githubDir,"labels.yml"),renderTemplate("github/labels.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(actionsDir,"setup-node-pnpm","action.yml"),renderTemplate("github/actions/setup-node-pnpm/action.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})];return shouldGenerateCodeownersNotification(config)&&files.push(writeFile(join(workflowsDir,"_post-merge-notify.yml"),renderTemplate("github/workflows/_post-merge-notify.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),usesJavaBuildAction(config)&&files.push(writeFile(join(actionsDir,"setup-java-maven","action.yml"),renderTemplate("github/actions/setup-java-maven/action.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),supportsCrossJobBuildCache(config)&&files.push(writeFile(join(actionsDir,"build-cache","action.yml"),renderTemplate("github/actions/build-cache/action.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.deployTarget==="nas-compose"&&files.push(writeFile(join(actionsDir,"nas-ssh","action.yml"),renderTemplate("github/actions/nas-ssh/action.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files}}function githubGenerationIsEnabled(config){return config.permitGitHub??config.useGitHub}function shouldGenerateCodeownersNotification(config){return config.governanceLevel!=="L1"&&config.enableCodeownersNotify===!0}function usesJavaBuildAction(config){return config.language==="java"||config.language==="kotlin"}function supportsCrossJobBuildCache(config){return["typescript","python","java"].includes(config.language)}

package/dist/generators/claude.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync}from"node:fs";import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{ensureDir,mergeSettingsJson,resolvedPath,writeFile,readFileTranslated}from"../utils/fs.js";import{DEFAULT_TASK_TIERS}from"../config/schema.js";import{resolveCollaborationAxes}from"../config/collaboration-mode-defaults.js";export function buildRenderContext(config){const taskTiers=config.taskTiers??DEFAULT_TASK_TIERS,axes=resolveCollaborationAxes(config);return{...config,taskTiers,...axes}}export function generateClaude(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data=buildRenderContext(config);return results.push(writeFile(resolvedPath(base,".claude","CLAUDE.md"),renderTemplate("claude/CLAUDE.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),generateClaudeSettings(base,data,results,opts.dryRun),generateClaudeHooks(base,data,config,results,opts.dryRun),generateClaudeRules(base,data,config,results,opts.dryRun),generateClaudeCommands(base,data,results,opts.dryRun),results.push(writeFile(resolvedPath(base,".claude","knowledge-map.json"),renderTemplate("claude/knowledge-map.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}function isPlainObject(x){return typeof x=="object"&&x!==null&&!Array.isArray(x)}export function parseExistingSettings(settingsPath){const raw=readFileTranslated(settingsPath,"utf-8");let parsed;try{parsed=JSON.parse(raw)}catch(err){const msg=err instanceof Error?err.message:String(err);throw new Error(`Failed to parse existing .claude/settings.json: ${msg}. Fix or delete and re-run.`,{cause:err})}if(!isPlainObject(parsed)){const kind=Array.isArray(parsed)?"array":parsed===null?"null":typeof parsed;throw new Error(`Failed to parse existing .claude/settings.json: expected JSON object, got ${kind}. Fix or delete and re-run.`)}return parsed}function generateClaudeSettings(base,data,results,dryRun){const settingsPath=resolvedPath(base,".claude","settings.json");if(!existsSync(settingsPath)){results.push(writeFile(settingsPath,renderTemplate("claude/settings.json.ejs",data),{dryRun}));return}const existing=parseExistingSettings(settingsPath),incoming=JSON.parse(renderTemplate("claude/settings.json.ejs",data)),merged=mergeSettingsJson(existing,incoming),mergedText=JSON.stringify(merged,null,2)+`
+`;results.push(writeFile(settingsPath,mergedText,{backup:!0,dryRun}))}const L2_ADVANCED_HOOKS=["post-edit-dispatch.mjs","debug-state-on-failure.mjs","skill-forced-eval.mjs","guard-task-completion.mjs","stop-evidence-guard.mjs","closer-mode-guard.mjs","exitplanmode-banner.mjs","stop-finding-loss.mjs"];export function planClaudeHooks(config){const isTs=config.language==="typescript"||config.language==="multi",entries=[],tpl=(file,template)=>{entries.push({file,template})};tpl("hooks.mjs","claude/hooks/hooks.mjs.ejs");for(const f of["stop-dangerous.mjs","enforce-read-only.mjs","pre-edit-ssot-guard.mjs","check-no-orphan-todo.mjs","check-no-placeholders.mjs","enforce-gate-before-pr.mjs","pre-spawn-worktree-guard.mjs","post-subagent-release.mjs"])tpl(f,`claude/hooks/${f}${f==="check-no-orphan-todo.mjs"||f==="check-no-placeholders.mjs"?".ejs":""}`);for(const f of["lib.mjs","post-commit-check.mjs"])tpl(f,`claude/hooks/${f}.ejs`);isTs&&tpl("check-no-unused-exports.mjs","claude/hooks/check-no-unused-exports.mjs"),config.enableNoSkippedTests!==!1&&tpl("check-no-skipped-tests.mjs","claude/hooks/check-no-skipped-tests.mjs");for(const hook of config.languageHooks)hook.name!=="check-no-orphan-todo.mjs"&&entries.push({file:hook.name,body:hook.body});if(tpl("pre-edit-plan-anchor.mjs","claude/hooks/pre-edit-plan-anchor.mjs.ejs"),tpl("pre-compact.mjs","claude/hooks/pre-compact.mjs.ejs"),config.governanceLevel!=="L1"){for(const f of L2_ADVANCED_HOOKS)tpl(f,`claude/hooks/${f}.ejs`);config.enableEvidenceHarness!==!1&&tpl("guard-done-evidence.mjs","claude/hooks/guard-done-evidence.mjs.ejs"),tpl("post-brainstorm-stop.mjs","claude/hooks/post-brainstorm-stop.mjs")}return isTs&&tpl("check-circular-deps.mjs","claude/hooks/check-circular-deps.mjs.ejs"),entries}function generateClaudeHooks(base,data,config,results,dryRun){const hooksDir=resolvedPath(base,".claude","hooks");dryRun||ensureDir(hooksDir);for(const entry of planClaudeHooks(config)){const content=entry.body??renderTemplate(entry.template,data);results.push(writeFile(join(hooksDir,entry.file),content,{skipIfExists:!0,dryRun}))}}export function planClaudeRules(config){const rules=[{file:"05-agent-lifecycle.md",template:"claude/rules/05-agent-lifecycle.md"},{file:"25-todo-folder-policy.md",template:"claude/rules/25-todo-folder-policy.md"},{file:"40-context-economy.md",template:"claude/rules/40-context-economy.md"},{file:"50-batch-execution.md",template:"claude/rules/50-batch-execution.md"},{file:"55-brainstorm-terminal-state.md",template:"claude/rules/55-brainstorm-terminal-state.md"},{file:"60-incidental-capture.md",template:"claude/rules/60-incidental-capture.md"},{file:"75-impact-vault-reading.md",template:"claude/rules/75-impact-vault-reading.md"},{file:"90-exec-protocol.md",template:"claude/rules/90-exec-protocol.md.ejs"},{file:"95-closer-mode.md",template:"claude/rules/95-closer-mode.md"}];return config.enableMcpFallback&&rules.push({file:"45-mcp-fallback.md",template:"claude/rules/45-mcp-fallback.md"}),rules}function generateClaudeRules(base,data,config,results,dryRun){const rulesDir=resolvedPath(base,".claude","rules");for(const rule of planClaudeRules(config))results.push(writeFile(join(rulesDir,rule.file),renderTemplate(rule.template,data),{skipIfExists:!0,dryRun}))}export const CLAUDE_COMMANDS=["task.md","ship.md","drain.md","impact.md","gold-audit.md","wt-open.md","wt-close.md","wt-list.md","wt-prune.md","close-gold-gap.md","levelup.md","tabletop.md"];function generateClaudeCommands(base,data,results,dryRun){const commandsDir=resolvedPath(base,".claude","commands");for(const cmd of CLAUDE_COMMANDS)results.push(writeFile(join(commandsDir,cmd),renderTemplate(`claude/commands/${cmd}.ejs`,data),{skipIfExists:!0,dryRun}))}

package/dist/generators/codex-hooks.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join,dirname}from"node:path";import{fileURLToPath}from"node:url";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath,readFileTranslated}from"../utils/fs.js";import{formatContent}from"../utils/prettier-format.js";const __dirname=dirname(fileURLToPath(import.meta.url));export const SHARED_GUARD_HOOKS=["stop-dangerous.mjs","enforce-read-only.mjs","pre-edit-ssot-guard.mjs","check-no-orphan-todo.mjs","check-no-placeholders.mjs"];export function generateCodexHooks(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data=config,hooksDir=resolvedPath(base,".claude","hooks");if(!config.tools.includes("claude")){results.push(writeFile(join(hooksDir,"lib.mjs"),renderTemplate("claude/hooks/lib.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));for(const hookFile of SHARED_GUARD_HOOKS){const templateFile=hookFile==="check-no-orphan-todo.mjs"||hookFile==="check-no-placeholders.mjs"?`${hookFile}.ejs`:hookFile;results.push(writeFile(join(hooksDir,hookFile),renderTemplate(`claude/hooks/${templateFile}`,data),{skipIfExists:!0,dryRun:opts.dryRun}))}config.enableNoSkippedTests!==!1&&results.push(writeFile(join(hooksDir,"check-no-skipped-tests.mjs"),renderTemplate("claude/hooks/check-no-skipped-tests.mjs",data),{skipIfExists:!0,dryRun:opts.dryRun}))}results.push(writeFile(resolvedPath(base,".codex","config.toml"),renderTemplate("codex/config.toml.ejs",data),{backup:!0,dryRun:opts.dryRun}));const adapterSrc=join(__dirname,"..","templates","codex","codex-adapter.mjs"),adapterDest=join(resolvedPath(base,".codex"),"codex-adapter.mjs"),adapterContent=formatContent(readFileTranslated(adapterSrc,"utf-8"),adapterDest,base);return results.push(writeFile(adapterDest,adapterContent,{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/codex-known-limitations.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{planClaudeHooks,planClaudeRules,CLAUDE_COMMANDS}from"./claude.js";import{AGENT_NAMES}from"./agents-claude.js";import{SKILL_NAMES}from"./skills.js";export const CODEX_DERIVED_RULES=[{file:"05-agent-lifecycle.md",template:"claude/rules/05-agent-lifecycle.md"},{file:"25-todo-folder-policy.md",template:"claude/rules/25-todo-folder-policy.md"},{file:"50-batch-execution.md",template:"claude/rules/50-batch-execution.md"},{file:"60-incidental-capture.md",template:"claude/rules/60-incidental-capture.md"},{file:"90-exec-protocol.md",template:"claude/rules/90-exec-protocol.md.ejs"}];const BRIDGED="Real-time: bridged via `.codex/config.toml` \u2192 `codex-adapter.mjs`",bridgedPlusGate=gate=>`${BRIDGED}; gate: ${gate}`,HOOK_DESCRIPTORS={"hooks.mjs":"infra","lib.mjs":"infra","stop-dangerous.mjs":{name:"stop-dangerous.mjs",enforces:"Blocks dangerous shell commands before execution",codexEquivalent:BRIDGED},"enforce-read-only.mjs":{name:"enforce-read-only.mjs",enforces:"Blocks edits to read-only / generated paths",codexEquivalent:BRIDGED},"pre-edit-ssot-guard.mjs":{name:"pre-edit-ssot-guard.mjs",enforces:"Warns on SSOT/governance file edits",codexEquivalent:BRIDGED},"check-no-orphan-todo.mjs":{name:"check-no-orphan-todo.mjs",enforces:"Blocks bare TODO without task ID (INV-06)",codexEquivalent:BRIDGED},"check-no-placeholders.mjs":{name:"check-no-placeholders.mjs",enforces:"Blocks stub content and unfinished scaffolding in edited files",codexEquivalent:BRIDGED},"check-no-skipped-tests.mjs":{name:"check-no-skipped-tests.mjs",enforces:"Blocks skipped/muted tests at edit time (INV-25)",codexEquivalent:BRIDGED},"check-no-pii.mjs":{name:"check-no-pii.mjs",enforces:"Blocks PII patterns in source (real-time)",codexEquivalent:BRIDGED},"enforce-gate-before-pr.mjs":{name:"enforce-gate-before-pr.mjs",enforces:"Blocks PR creation before the local gate passed",codexEquivalent:bridgedPlusGate("`node scripts/check-all.mjs L2` before push")},"post-commit-check.mjs":{name:"post-commit-check.mjs",enforces:"Post-commit checklist verification",codexEquivalent:BRIDGED},"check-no-unused-exports.mjs":{name:"check-no-unused-exports.mjs",enforces:"Blocks unused TypeScript exports (dead code)",codexEquivalent:bridgedPlusGate("dead-code check (`knip`) in `check-all.mjs`")},"check-no-any.mjs":{name:"check-no-any.mjs",enforces:"Blocks TypeScript `any` types (INV-04)",codexEquivalent:bridgedPlusGate("`tsc --strict`")},"check-no-unwrap.mjs":{name:"check-no-unwrap.mjs",enforces:"Blocks `.unwrap()` outside tests (Rust)",codexEquivalent:"Gate: clippy lint step in `check-all.mjs`"},"check-no-unchecked-err.mjs":{name:"check-no-unchecked-err.mjs",enforces:"Blocks unchecked `err` returns (Go)",codexEquivalent:"Gate: errcheck/vet step in `check-all.mjs`"},"check-no-bare-except.mjs":{name:"check-no-bare-except.mjs",enforces:"Blocks bare `except:` clauses (Python)",codexEquivalent:"Gate: ruff lint step in `check-all.mjs`"},"check-no-raw-types.mjs":{name:"check-no-raw-types.mjs",enforces:"Blocks raw generic types (Java)",codexEquivalent:"Gate: compiler lint step in `check-all.mjs`"},"check-no-mockmvc.mjs":{name:"check-no-mockmvc.mjs",enforces:"Blocks MockMvc in favour of real-server tests (Java)",codexEquivalent:"Gate: test-realism checks in `check-all.mjs`"},"pre-edit-plan-anchor.mjs":{name:"pre-edit-plan-anchor.mjs",enforces:"Requires plan file in implementation phase",codexEquivalent:"`.agents/plan/PLAN.json` protocol"},"pre-compact.mjs":{name:"pre-compact.mjs",enforces:"Snapshots task state before context compaction",codexEquivalent:BRIDGED},"post-edit-dispatch.mjs":{name:"post-edit-dispatch.mjs",enforces:"Runs post-edit agents for quality checks",codexEquivalent:"None \u2014 manual code review"},"debug-state-on-failure.mjs":{name:"debug-state-on-failure.mjs",enforces:"Persists debug state on gate failure",codexEquivalent:"None \u2014 manual logging"},"skill-forced-eval.mjs":{name:"skill-forced-eval.mjs",enforces:"Forces skill invocation before task start",codexEquivalent:BRIDGED},"guard-task-completion.mjs":{name:"guard-task-completion.mjs",enforces:"Blocks premature done claims",codexEquivalent:BRIDGED},"stop-evidence-guard.mjs":{name:"stop-evidence-guard.mjs",enforces:"Fail-closed completion backstop (INV-114)",codexEquivalent:"None \u2014 manual discipline"},"closer-mode-guard.mjs":{name:"closer-mode-guard.mjs",enforces:"CLOSER-mode enforcement in the close phase",codexEquivalent:BRIDGED},"exitplanmode-banner.mjs":{name:"exitplanmode-banner.mjs",enforces:"Plan-exit banner in the task lifecycle",codexEquivalent:"None \u2014 informational only"},"guard-done-evidence.mjs":{name:"guard-done-evidence.mjs",enforces:"Requires recorded evidence before done claims",codexEquivalent:bridgedPlusGate("`arbiter verify tdd` / evidence checks")},"post-brainstorm-stop.mjs":{name:"post-brainstorm-stop.mjs",enforces:"Brainstorm terminal-state guardrail (#1265)",codexEquivalent:BRIDGED},"check-circular-deps.mjs":{name:"check-circular-deps.mjs",enforces:"Detects circular deps per-edit (INV-01)",codexEquivalent:bridgedPlusGate("`madge --circular src` in `check-all.mjs`")},"wiki-on-commit.mjs":{name:"wiki-on-commit.mjs",enforces:"Regenerates the LLM wiki on commit (INV-116)",codexEquivalent:"Gate: wiki-lint check in `check-all.mjs`"},"pre-spawn-worktree-guard.mjs":{name:"pre-spawn-worktree-guard.mjs",enforces:"Refuses a second write-intent sub-agent spawn onto the main tree (E5 #1947)",codexEquivalent:"None \u2014 manual worktree discipline"},"post-subagent-release.mjs":{name:"post-subagent-release.mjs",enforces:"SubagentStop cleanup companion to pre-spawn-worktree-guard.mjs \u2014 releases the finished dispatch agents-active.json sidecar entry (#2403)",codexEquivalent:BRIDGED},"stop-finding-loss.mjs":{name:"stop-finding-loss.mjs",enforces:"Detects research dispatches with zero persisted findings (E6b #1948)",codexEquivalent:"None \u2014 manual discipline"}};export function planClaudeHookInventory(config){const names=planClaudeHooks(config).map(e=>e.file);return config.existing.aiRulez||(config.enableSecurityScanning&&names.push("check-no-pii.mjs"),config.governanceLevel!=="L1"&&config.tools.includes("claude")&&names.push("wiki-on-commit.mjs")),names}export function buildKnownLimitations(config){const hooks=[];for(const name of planClaudeHookInventory(config)){const descriptor=HOOK_DESCRIPTORS[name];if(descriptor===void 0)throw new Error(`codex-known-limitations: no descriptor for Claude hook "${name}" \u2014 add a row to HOOK_DESCRIPTORS (ADR-106: every emitted hook must be disclosed in the CODEX.md Known Limitations table)`);descriptor!=="infra"&&hooks.push(descriptor)}const codexRuleFiles=new Set(CODEX_DERIVED_RULES.map(r=>r.file)),claudeOnlyRules=planClaudeRules(config).map(r=>r.file).filter(f=>!codexRuleFiles.has(f));return{hooks,commands:CLAUDE_COMMANDS.map(c=>c.replace(/\.md$/,"")),agents:[...AGENT_NAMES],skills:[...SKILL_NAMES],claudeOnlyRules}}

package/dist/generators/codex.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{generateCodexHooks}from"./codex-hooks.js";import{buildKnownLimitations,CODEX_DERIVED_RULES}from"./codex-known-limitations.js";export function generateCodex(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data={...config,knownLimitations:buildKnownLimitations(config)};results.push(writeFile(resolvedPath(base,".agents","CODEX.md"),renderTemplate("codex/CODEX.md.ejs",data),{backup:!0,dryRun:opts.dryRun}));const rulesDir=resolvedPath(base,".agents","rules");for(const rule of CODEX_DERIVED_RULES)results.push(writeFile(join(rulesDir,rule.file),renderTemplate(rule.template,data),{skipIfExists:!0,dryRun:opts.dryRun}));const planDir=resolvedPath(base,".agents","plan");results.push(writeFile(join(planDir,"README.md"),PLAN_README,{skipIfExists:!0,dryRun:opts.dryRun}));const hookResult=generateCodexHooks(config,opts);return results.push(...hookResult.files),{files:results}}const PLAN_README=`# .agents/plan/
+
+Task plan artifacts for Codex execution.
+
+## Files
+
+- \`PLAN.json\` \u2014 current task plan (created by Codex before implementation)
+- \`CONTEXT_PACK.md\` \u2014 context digest for the current task
+- \`runs/\` \u2014 historical run snapshots
+
+## Plan Schema
+
+See \`.agents/CODEX.md\` \xA7Plan Schema for the required format.
+`;

package/dist/generators/commit-footer.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateCommitFooter(config,opts={dryRun:!1}){const base=config.targetDir,data=config;return{files:[writeFile(resolvedPath(base,"scripts","check-commit-footer-rationale.mjs"),renderTemplate("scripts/check-commit-footer-rationale.mjs.ejs",data),{dryRun:opts.dryRun})]}}

package/dist/generators/compliance-menu.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateComplianceMenu(config,opts={dryRun:!1}){const path=resolvedPath(config.targetDir,"docs","COMPLIANCE_MENU.md"),content=renderTemplate("compliance/compliance-menu.md.ejs",config);return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/compliance.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateCompliance(config,opts={dryRun:!1}){const path=resolvedPath(config.targetDir,"docs","COMPLIANCE_MAPPING.md"),content=renderTemplate("compliance/compliance-mapping.md.ejs",config);return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/conformance.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{writeFile,resolvedPath}from"../utils/fs.js";import{renderTemplate}from"../utils/render.js";export function generateConformanceScript(config,opts={dryRun:!1}){const path=resolvedPath(config.targetDir,"scripts","conformance.mjs"),content=renderTemplate("scripts/conformance.mjs.ejs",config);return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/contract-testing.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{mutatePackageJson}from"../utils/pkg.js";import{formatContent}from"../utils/prettier-format.js";import{getLogger}from"../utils/logger.js";import{isL3Allowed}from"../utils/maturity-check.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";const SPRINGDOC_OPENAPI_PLUGIN_VERSION="1.8.0";function injectPactPackageJson(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const devDeps=pkg.devDependencies??{};return devDeps["@pact-foundation/pact"]?!1:(devDeps["@pact-foundation/pact"]="^16.4.0",pkg.devDependencies=devDeps,!0)})}function javaContractsPkg(config){if(config.basePackage){if(!/^[a-zA-Z][a-zA-Z0-9._-]*$/.test(config.basePackage))throw new Error(`Invalid basePackage identifier: ${config.basePackage}`);return`src/test/java/${config.basePackage.replace(/\./g,"/")}/contracts`}return"src/test/java/contracts"}function contractFile(cfOpts){const{base,config,data,templateDir,tsFile,javaFile,rustFile,goFile,pyFile,dryRun,tsPathSegments=["src","test","contracts"],formatTs=!1}=cfOpts,out=cfOpts.extraFiles??[],skip={skipIfExists:!0,dryRun};if(config.language==="typescript"||config.language==="multi"){const tsPath=resolvedPath(base,...tsPathSegments,tsFile),tsContent=renderTemplate(`contract-testing/${templateDir}/${tsFile}.ejs`,data);out.push(writeFile(tsPath,formatTs?formatContent(tsContent,tsPath,base):tsContent,skip))}if(config.language==="java"||config.language==="multi"){const pkg=javaContractsPkg(config);out.push(writeFile(resolvedPath(base,pkg,javaFile),renderTemplate(`contract-testing/${templateDir}/${javaFile}.ejs`,data),skip))}return config.language==="rust"?out.push(writeFile(resolvedPath(base,"tests",rustFile),renderTemplate(`contract-testing/${templateDir}/${rustFile}.ejs`,data),skip)):config.language==="go"?out.push(writeFile(resolvedPath(base,"tests",goFile),renderTemplate(`contract-testing/${templateDir}/${goFile}.ejs`,data),skip)):config.language==="python"&&out.push(writeFile(resolvedPath(base,"tests","contract",pyFile),renderTemplate(`contract-testing/${templateDir}/${pyFile}.ejs`,data),skip)),out}function generateApiContractBaselines(base,data,dryRun){const snapshotsBase=resolvedPath(base,"src","test","resources","api-snapshots"),pactSamplesBase=resolvedPath(base,"src","test","resources","pact-samples"),skip={skipIfExists:!0,dryRun},out=[],snapshotStubs=["openapi-baseline.json","openapi-paths-baseline.json","openapi-response-status-baseline.json","openapi-content-types-baseline.json","openapi-required-fields-baseline.json","config-response-baseline.json","config-keys-baseline.json","enum-values-baseline.json","error-shape-baseline.json","test-snapshot.json"];for(const name of snapshotStubs)out.push(writeFile(resolvedPath(snapshotsBase,name),renderTemplate(`contract-testing/api-snapshots/${name}.ejs`,data),skip));const pactStubs=["assignment-response.json","availability-response.json","availability-rule-response.json","capacity-response.json","fully-booked-response.json","schedule-override-response.json"];for(const name of pactStubs)out.push(writeFile(resolvedPath(pactSamplesBase,name),renderTemplate(`contract-testing/pact-samples/${name}.ejs`,data),skip));return out.push(writeFile(resolvedPath(base,"scripts","validate-api-snapshots.mjs"),renderTemplate("scripts/validate-api-snapshots.mjs.ejs",data),skip),writeFile(resolvedPath(base,"scripts","validate-openapi-field-types.mjs"),renderTemplate("scripts/validate-openapi-field-types.mjs.ejs",data),skip),writeFile(resolvedPath(base,"scripts","validate-postman-collection.mjs"),renderTemplate("scripts/validate-postman-collection.mjs.ejs",data),skip)),out}function generateRestOwned(base,config,data,dryRun){const extra=[writeFile(resolvedPath(base,".env.pact"),renderTemplate("contract-testing/env/.env.pact.ejs",data),{skipIfExists:!0,dryRun}),writeFile(resolvedPath(base,"pacts",".gitkeep"),"",{skipIfExists:!0,dryRun})];if((config.language==="java"||config.language==="multi")&&(extra.push(writeFile(resolvedPath(base,"config","pact-deps.gradle"),renderTemplate("contract-testing/rest-owned/pact-deps.gradle.ejs",data),{skipIfExists:!0,dryRun})),config.buildTool==="gradle")){const applyPactDeps=safeApplyFromSnippet(base,"config/pact-deps.gradle");applyPactDeps&&injectGradleWiring(base,dryRun,{snippets:[applyPactDeps]})}return(config.language==="java"||config.language==="multi")&&extra.push(writeFile(resolvedPath(base,"scripts","run-postman-tests.sh"),renderTemplate("scripts/run-postman-tests.sh.ejs",data),{skipIfExists:!0,dryRun}),writeFile(resolvedPath(base,"scripts","inject-pact-samples.sh"),renderTemplate("scripts/inject-pact-samples.sh.ejs",data),{skipIfExists:!0,dryRun}),writeFile(resolvedPath(base,".github","workflows","_contract-postman.yml"),renderTemplate("github/workflows/_contract-postman.yml.ejs",data),{skipIfExists:!0,dryRun})),(config.language==="java"||config.language==="multi")&&extra.push(...generateApiContractBaselines(base,data,dryRun)),(config.language==="typescript"||config.language==="multi")&&injectPactPackageJson(base,dryRun),contractFile({base,config,data,templateDir:"rest-owned",tsFile:"pact-consumer.test.ts",javaFile:"PactVerificationIT.java",rustFile:"pact_consumer_test.rs",goFile:"pact_consumer_test.go",pyFile:"test_pact_consumer.py",tsPathSegments:["__tests__","contract"],formatTs:!0,extraFiles:extra,dryRun})}function generateRestPublic(base,config,data,dryRun){const skip={skipIfExists:!0,dryRun},extra=[];if((config.language==="typescript"||config.language==="multi")&&extra.push(writeFile(resolvedPath(base,"export-openapi.mjs"),renderTemplate("contract-testing/rest-public/export-openapi.mjs.ejs",data),skip)),(config.language==="java"||config.language==="multi")&&(extra.push(writeFile(resolvedPath(base,"config","export-openapi-java.gradle"),renderTemplate("contract-testing/rest-public/export-openapi-java.gradle.ejs",data),skip)),config.buildTool==="gradle")){const applyExportOpenapi=safeApplyFromSnippet(base,"config/export-openapi-java.gradle");applyExportOpenapi&&injectGradleWiring(base,dryRun,{plugins:[{id:"org.springdoc.openapi-gradle-plugin",version:SPRINGDOC_OPENAPI_PLUGIN_VERSION}],snippets:[applyExportOpenapi]})}return config.language==="rust"?extra.push(writeFile(resolvedPath(base,"src","bin","export_openapi.rs"),renderTemplate("contract-testing/rest-public/export_openapi.rs.ejs",data),skip)):config.language==="go"?extra.push(writeFile(resolvedPath(base,"cmd","export-openapi","main.go"),renderTemplate("contract-testing/rest-public/export_openapi.go.ejs",data),skip)):config.language==="python"&&extra.push(writeFile(resolvedPath(base,"export_openapi.py"),renderTemplate("contract-testing/rest-public/export_openapi.py.ejs",data),skip)),contractFile({base,config,data,templateDir:"rest-public",tsFile:"openapi-diff.ts",javaFile:"OpenApiDiffIT.java",rustFile:"openapi_diff_test.rs",goFile:"openapi_diff_test.go",pyFile:"test_openapi_diff.py",extraFiles:extra,dryRun})}function generateGraphql(base,config,data,dryRun){return contractFile({base,config,data,templateDir:"graphql",tsFile:"graphql-inspector.test.ts",javaFile:"GraphqlSchemaTest.java",rustFile:"graphql_schema_test.rs",goFile:"graphql_schema_test.go",pyFile:"test_graphql_schema.py",dryRun})}function generateGrpc(base,config,data,dryRun){const skip={skipIfExists:!0,dryRun},shared=[writeFile(resolvedPath(base,"proto","buf.yaml"),renderTemplate("contract-testing/grpc/buf.yaml.ejs",data),skip),writeFile(resolvedPath(base,"proto","buf-breaking.yml"),renderTemplate("contract-testing/grpc/buf-breaking.yml.ejs",data),skip)];return contractFile({base,config,data,templateDir:"grpc",tsFile:"grpc-contract.test.ts",javaFile:"GrpcContractTest.java",rustFile:"grpc_contract_test.rs",goFile:"grpc_contract_test.go",pyFile:"test_grpc_contract.py",extraFiles:shared,dryRun})}function generateMessageQueue(base,config,data,dryRun){return contractFile({base,config,data,templateDir:"message-queue",tsFile:"schema-registry-check.ts",javaFile:"SchemaRegistryCheckIT.java",rustFile:"schema_registry_test.rs",goFile:"schema_registry_test.go",pyFile:"test_schema_registry.py",dryRun})}export function generateContractTesting(config,opts={dryRun:!1}){if(config.contractType==="none"||config.governanceLevel==="L1")return{files:[]};const dispatchers={"rest-owned":generateRestOwned,"rest-public":generateRestPublic,graphql:generateGraphql,grpc:generateGrpc,"message-queue":generateMessageQueue};if(!config.hasPublicApi)return{files:[]};const{language,acceptBetaTools=!1}=config;if(language!=="multi"&&!isL3Allowed(language,"contract",acceptBetaTools).allowed)return{files:[]};const handler=dispatchers[config.contractType];if(!handler)return getLogger().warn("contract_testing.unknown_contract_type",{contract_type:config.contractType},`Unknown contractType: ${config.contractType} \u2014 skipping`),{files:[]};const base=config.targetDir,data=config,results=[writeFile(resolvedPath(base,"CONTRACTS_POLICY.md"),renderTemplate("contract-testing/CONTRACTS_POLICY.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})];return results.push(...handler(base,config,data,opts.dryRun)),{files:results}}

package/dist/generators/coverage.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{resolveEffectiveThresholds}from"../config/thresholds.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";const KOVER_PLUGIN_VERSION="0.9.8";function binarySizeBudget(archetype){return archetype==="cli"?10*1048576:archetype==="embedded"?5*1048576:0}export function generateCoverage(config,opts={dryRun:!1}){if(!config.enableDebtGates)return{files:[]};const results=[],base=config.targetDir,effective=resolveEffectiveThresholds(config),data={...config,thresholds:{...config.thresholds,lineCoverage:effective.lineCoverage,branchCoverage:effective.branchCoverage},coverageThreshold:effective.lineCoverage,coverageEnabled:effective.coverageEnabled,binarySizeBytes:binarySizeBudget(config.archetype)};if((config.language==="typescript"||config.language==="multi")&&results.push(writeFile(resolvedPath(base,"vitest.config.ts"),renderTemplate("coverage/vitest.config.ts.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),(config.language==="java"||config.language==="multi")&&config.buildTool==="gradle"){results.push(writeFile(resolvedPath(base,"gradle","jacoco.gradle"),renderTemplate("coverage/jacoco.gradle.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const applyJacoco=safeApplyFromSnippet(base,"gradle/jacoco.gradle",{rootBuildSignatures:[/(?:^|\n)[ \t]*jacoco\s*\{/]});applyJacoco&&injectGradleWiring(base,opts.dryRun,{snippets:[applyJacoco]})}return(config.language==="java"||config.language==="multi")&&config.buildTool==="maven"&&results.push(writeFile(resolvedPath(base,"docs","coverage","jacoco-maven-setup.md"),renderTemplate("coverage/jacoco-maven-setup.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.language==="rust"&&results.push(...emitRustCoverage(base,config,data,opts.dryRun)),results.push(...emitSingleFileCoverage(config.language,base,data,opts.dryRun)),{files:results}}function emitSingleFileCoverage(language,base,data,dryRun){return language==="python"?[writeFile(resolvedPath(base,".coveragerc"),renderTemplate("coverage/.coveragerc.ejs",data),{skipIfExists:!0,dryRun})]:language==="kotlin"?emitKotlinCoverage(base,data,dryRun):[]}function emitKotlinCoverage(base,data,dryRun){const result=writeFile(resolvedPath(base,"kover.gradle"),renderTemplate("coverage/kover.gradle.ejs",data),{skipIfExists:!0,dryRun}),applyKover=safeApplyFromSnippet(base,"kover.gradle",{rootBuildSignatures:[/(?:^|\n)[ \t]*kover\s*\{/]});return applyKover&&injectGradleWiring(base,dryRun,{plugins:[{id:"org.jetbrains.kotlinx.kover",version:KOVER_PLUGIN_VERSION}],snippets:[applyKover]}),[result]}function emitRustCoverage(base,config,data,dryRun){const out=[writeFile(resolvedPath(base,".tarpaulin.toml"),renderTemplate("coverage/.tarpaulin.toml.ejs",data),{skipIfExists:!0,dryRun})];return(config.archetype==="cli"||config.archetype==="embedded")&&out.push(writeFile(resolvedPath(base,"docs","coverage","Cargo.toml.profile.release"),renderTemplate("coverage/Cargo.toml.profile.release.ejs",data),{skipIfExists:!0,dryRun})),out}

package/dist/generators/debt-gates.js

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: Apache-2.0
+import{execFileSync}from"node:child_process";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{mutatePackageJson}from"../utils/pkg.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";function injectTestScripts(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const scripts=pkg.scripts??{},testScripts={"test:unit":"vitest run src","test:contract":"vitest run --passWithNoTests __tests__/contract","test:integration":"vitest run --passWithNoTests __tests__/integrations","test:behavioral":"vitest run --passWithNoTests __tests__/behavioral"};let changed=!1;for(const[key,value]of Object.entries(testScripts))scripts[key]||(scripts[key]=value,changed=!0);return changed&&(pkg.scripts=scripts),changed})}function injectTypeScriptGateScripts(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const scripts=pkg.scripts??{},gateScripts={typecheck:"tsc --noEmit",lint:"eslint .",build:"tsc -p tsconfig.json"};let changed=!1;for(const[key,value]of Object.entries(gateScripts))scripts[key]||(scripts[key]=value,changed=!0);return changed&&(pkg.scripts=scripts),changed})}function injectDepCruiserPackageJson(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const scripts=pkg.scripts??{},devDeps=pkg.devDependencies??{};let changed=!1;return scripts["check:arch"]||(scripts["check:arch"]="depcruise src",pkg.scripts=scripts,changed=!0),devDeps["dependency-cruiser"]||(devDeps["dependency-cruiser"]="^16.0.0",pkg.devDependencies=devDeps,changed=!0),changed})}const TS_GATE_DEVDEPS={typescript:"^5.6.0","@types/node":"^22.0.0",prettier:"^3.3.0",eslint:"^9.13.0","@eslint/js":"^9.13.0","typescript-eslint":"^8.10.0",vitest:"^3.0.0"},VITEST_COVERAGE="@vitest/coverage-v8",DEFAULT_VITEST_COVERAGE_SELECTOR="^3.0.0",ORDINARY_VITEST_SELECTOR=/^(?:\^|~)?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;function coverageSelectorFor(vitestSelector){return vitestSelector!==void 0&&ORDINARY_VITEST_SELECTOR.test(vitestSelector)?vitestSelector:DEFAULT_VITEST_COVERAGE_SELECTOR}function injectTsGateToolchain(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const devDeps=pkg.devDependencies??{},dependencies=pkg.dependencies;let changed=!1;for(const[name,version]of Object.entries(TS_GATE_DEVDEPS))!devDeps[name]&&!dependencies?.[name]&&(devDeps[name]=version,changed=!0);return!devDeps[VITEST_COVERAGE]&&!dependencies?.[VITEST_COVERAGE]&&(devDeps[VITEST_COVERAGE]=coverageSelectorFor(devDeps.vitest??dependencies?.vitest),changed=!0),changed&&(pkg.devDependencies=devDeps),changed})}function injectFormatScript(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const scripts=pkg.scripts??{};return scripts.format?!1:(scripts.format="prettier --check .",pkg.scripts=scripts,!0)})}function emitTsGateScaffold(base,data,dryRun){return[["tsconfig.json","root/tsconfig.json.ejs"],[".prettierrc.json","static-analysis/prettierrc.json.ejs"],[".prettierignore","static-analysis/prettierignore.ejs"],["eslint.config.mjs","static-analysis/eslint.config.mjs.ejs"],["eslint.config.static.mjs","static-analysis/eslint.config.static.mjs.ejs"],[".eslintrc-static.json","static-analysis/eslintrc-static.json.ejs"]].map(([rel,tmpl])=>writeFile(resolvedPath(base,rel),renderTemplate(tmpl,data),{skipIfExists:!0,dryRun}))}const CHECKSTYLE_TOOL_VERSION="10.21.4",PMD_TOOL_VERSION="7.10.0",SPOTBUGS_PLUGIN_VERSION="6.0.18",SPOTLESS_PLUGIN_VERSION="7.0.3";function detectSpotlessRatchetRef(targetDir){for(const ref of["origin/main","origin/master"])try{return execFileSync("git",["-C",targetDir,"rev-parse","--verify","--quiet",`refs/remotes/${ref}`],{stdio:"ignore"}),ref}catch{}return null}function isJavaLike(config){return config.language==="java"||config.language==="multi"}function pushJavaGateEssentials(results,config,data,dryRun){if(!isJavaLike(config))return;const base=config.targetDir,javaData={...data,spotlessRatchetFrom:detectSpotlessRatchetRef(base)},files=[[resolvedPath(base,"config","checkstyle.xml"),"static-analysis/checkstyle.xml.ejs"],[resolvedPath(base,"spotless.gradle"),"static-analysis/spotless.gradle.ejs"]];for(const[path,tmpl]of files)results.push(writeFile(path,renderTemplate(tmpl,javaData),{skipIfExists:!0,dryRun}));if(config.buildTool!=="gradle")return;const snippets=[{signature:/(?:^|\n)[ \t]*checkstyle\s*\{/,kts:`checkstyle {
+    toolVersion = "${CHECKSTYLE_TOOL_VERSION}"
+    configFile = file("config/checkstyle.xml")
+}`,groovy:`checkstyle {
+    toolVersion = '${CHECKSTYLE_TOOL_VERSION}'
+    configFile = file('config/checkstyle.xml')
+}`}],applySpotless=safeApplyFromSnippet(base,"spotless.gradle",{rootBuildSignatures:[/(?:^|\n)[ \t]*spotless\s*\{/]});applySpotless&&snippets.push(applySpotless),injectGradleWiring(base,dryRun,{plugins:[{id:"checkstyle"},{id:"com.diffplug.spotless",version:SPOTLESS_PLUGIN_VERSION}],snippets})}function pushJavaDebtGates(results,config,data,dryRun){if(!isJavaLike(config))return;const base=config.targetDir,files=[[resolvedPath(base,"config","pmd-ruleset.xml"),"static-analysis/pmd-ruleset.xml.ejs"],[resolvedPath(base,"config","spotbugs-exclude.xml"),"static-analysis/spotbugs-exclude.xml.ejs"],[resolvedPath(base,"config","pitest-setup.md"),"mutation/pitest-l2-setup.md.ejs"],[resolvedPath(base,"spotbugs.gradle"),"static-analysis/spotbugs.gradle.ejs"],[resolvedPath(base,"scripts","verify-spotbugs.mjs"),"scripts/verify-spotbugs.mjs.ejs"],[resolvedPath(base,"spotbugs-baseline.json"),"scripts/spotbugs-baseline.json.ejs"]];for(const[path,tmpl]of files)results.push(writeFile(path,renderTemplate(tmpl,data),{skipIfExists:!0,dryRun}));if(config.buildTool!=="gradle")return;const spotbugsInlineSignature=/(?:^|\n)[ \t]*spotbugs\s*\{/,snippets=[{signature:/(?:^|\n)[ \t]*pmd\s*\{/,kts:`pmd {
+    toolVersion = "${PMD_TOOL_VERSION}"
+    ruleSetFiles = files("config/pmd-ruleset.xml")
+    ruleSets = listOf()
+}`,groovy:`pmd {
+    toolVersion = '${PMD_TOOL_VERSION}'
+    ruleSetFiles = files('config/pmd-ruleset.xml')
+    ruleSets = []
+}`},{signature:spotbugsInlineSignature,kts:`spotbugs {
+    effort.set(com.github.spotbugs.snom.Effort.MAX)
+    reportLevel.set(com.github.spotbugs.snom.Confidence.MEDIUM)
+    excludeFilter.set(file("config/spotbugs-exclude.xml"))
+}`,groovy:`spotbugs {
+    effort = com.github.spotbugs.snom.Effort.valueOf('MAX')
+    reportLevel = com.github.spotbugs.snom.Confidence.valueOf('MEDIUM')
+    excludeFilter = file('config/spotbugs-exclude.xml')
+}`}],applySpotbugs=safeApplyFromSnippet(base,"spotbugs.gradle",{rootBuildSignatures:[spotbugsInlineSignature]});applySpotbugs&&snippets.push(applySpotbugs),injectGradleWiring(base,dryRun,{plugins:[{id:"pmd"},{id:"com.github.spotbugs",version:SPOTBUGS_PLUGIN_VERSION}],snippets})}export function generateDebtGates(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data={...config,strictnessTier:config.strictnessTier??"practical"};for(const[rel,tmpl]of[[".yamllint.yml","static-analysis/.yamllint.yml.ejs"],[".shellcheckrc","static-analysis/.shellcheckrc.ejs"]])results.push(writeFile(resolvedPath(base,rel),renderTemplate(tmpl,data),{skipIfExists:!0,dryRun:opts.dryRun}));return(config.language==="typescript"||config.language==="multi")&&(injectTestScripts(base,opts.dryRun),injectTypeScriptGateScripts(base,opts.dryRun),results.push(...emitTsGateScaffold(base,data,opts.dryRun)),injectTsGateToolchain(base,opts.dryRun),injectFormatScript(base,opts.dryRun)),pushJavaGateEssentials(results,config,data,opts.dryRun),config.language==="python"&&(results.push(writeFile(resolvedPath(base,"ruff.toml"),renderTemplate("static-analysis/ruff.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"requirements-dev.txt"),renderTemplate("static-analysis/requirements-dev.txt.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}))),config.enableDebtGates?((config.language==="typescript"||config.language==="multi")&&(results.push(writeFile(resolvedPath(base,"knip.json"),renderTemplate("static-analysis/knip.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,".dependency-cruiser.cjs"),renderTemplate("static-analysis/.dependency-cruiser.cjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),injectDepCruiserPackageJson(base,opts.dryRun)),config.language==="rust"&&results.push(writeFile(resolvedPath(base,"rustfmt.toml"),renderTemplate("static-analysis/rustfmt.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.language==="go"&&results.push(writeFile(resolvedPath(base,".golangci.yml"),renderTemplate("static-analysis/.golangci.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),pushJavaDebtGates(results,config,data,opts.dryRun),config.language==="kotlin"&&pushKotlinDebtGates(results,base,data,opts.dryRun),{files:results}):{files:results}}function pushKotlinDebtGates(results,base,data,dryRun){results.push(writeFile(resolvedPath(base,"config","detekt","detekt.yml"),renderTemplate("static-analysis/detekt.yml.ejs",data),{skipIfExists:!0,dryRun}))}

package/dist/generators/debt-ratchet.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function computeMetricsProfile(config){return{includeBundleSize:config.archetype==="frontend-spa"&&config.language==="typescript",includePublicApiSurface:config.archetype==="library"&&config.language==="typescript",includeBranchCoverage:config.archetype==="backend-web-db"||config.archetype==="library",spotbugsEnabled:config.language==="java"||config.language==="multi",archunitEnabled:(config.language==="java"||config.language==="multi")&&config.architectureStyle!=="none"}}export function generateDebtRatchet(config,opts={dryRun:!1}){if(!config.enableDebtGates)return{files:[]};const base=config.targetDir,metricsProfile=computeMetricsProfile(config),data={...config,metricsProfile};return{files:[writeFile(resolvedPath(base,"scripts","debt-lib.mjs"),renderTemplate("scripts/debt-lib.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","capture-debt-baseline.mjs"),renderTemplate("scripts/capture-debt-baseline.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","debt-report.mjs"),renderTemplate("scripts/debt-report.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun})]}}

package/dist/generators/derived-class.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{CODEX_DERIVED_RULES}from"./codex-known-limitations.js";import{SHARED_GUARD_HOOKS}from"./codex-hooks.js";export const DERIVED_TRACK_KEYS=[...CODEX_DERIVED_RULES.map(rule=>`.agents/rules/${rule.file}`),".claude/hooks/lib.mjs",...SHARED_GUARD_HOOKS.map(hook=>`.claude/hooks/${hook}`),".claude/hooks/check-no-skipped-tests.mjs",".codex/codex-adapter.mjs"];const DERIVED_TRACK_KEY_SET=new Set(DERIVED_TRACK_KEYS);export function isDerivedTrackKey(key){return DERIVED_TRACK_KEY_SET.has(key)}

package/dist/generators/doc-set.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+import{basename,resolve}from"node:path";import{existsSync}from"node:fs";import{writeFile,resolvedPath,readFileTranslated}from"../utils/fs.js";import{renderTemplate}from"../utils/render.js";import{formatContent}from"../utils/prettier-format.js";import{runDocSet}from"../commands/doc-set.js";import{isoToday}from"../utils/today.js";const SKELETON_CATALOG={arc42:{variants:{solo:"docs/skeletons/arc42-canvas.md.ejs",small:"docs/skeletons/arc42-canvas.md.ejs",enterprise:"docs/skeletons/arc42-full.md.ejs"}},"adr-seed":{variants:"docs/adr/ADR-000_template.md.ejs",targetOverride:"docs/ADR/ADR-000_template.md"},slo:{variants:"docs/skeletons/slo.md.ejs"},"threat-model":{variants:{solo:"docs/skeletons/threat-model-4q.md.ejs",small:"docs/skeletons/threat-model-4q.md.ejs",enterprise:"docs/skeletons/threat-model-stride.md.ejs"}},"er-model":{variants:"docs/skeletons/er-model.md.ejs"},glossary:{variants:"docs/skeletons/glossary.md.ejs"},"test-strategy":{variants:"docs/skeletons/test-strategy.md.ejs"},governance:{variants:"docs/skeletons/governance.md.ejs"},"technical-debt":{variants:"docs/skeletons/technical-debt.md.ejs"},"decision-registry":{variants:"docs/skeletons/decision-registry.md.ejs"}};function resolveTemplatePath(entry,column){return typeof entry.variants=="string"?entry.variants:entry.variants[column]}function frontmatter(title,today){return["---",`title: '${title}'`,"doc_version: '0.1.0'","status: draft",`last_review: '${today}'`,"owner: ''","canonical_id: ''","tags: ['audience/dev', 'kind/reference']","related: []","---",""].join(`
+`)}function bannerStubFingerprint(path,purpose){const title=basename(path).replace(/\.md$/,""),banner=`> **STUB \u2014 fill me in.** Scaffolded by \`check-doc-set --generate\` to satisfy the gold doc-set. ${purpose??""}`.trim();return[frontmatter(title,"<DATE>"),`# ${title}`,"",banner,""].join(`
+`)}function isUntouchedBannerStub(disk,path,purpose){return disk.replace(/^last_review: '.*'$/m,"last_review: '<DATE>'")===bannerStubFingerprint(path,purpose)}function scaffoldRow(item,entry,ctx){const templatePath=resolveTemplatePath(entry,ctx.tierColumn),targetRel=entry.targetOverride??item.path,targetAbs=resolvedPath(ctx.repo,targetRel),diskExists=existsSync(targetAbs),bannerDetected=item.path.endsWith(".md")&&diskExists&&isUntouchedBannerStub(readFileTranslated(targetAbs,"utf-8"),item.path,item.purpose);if(!(bannerDetected||item.isMissing&&!diskExists))return null;const title=basename(targetRel).replace(/\.md$/,""),body=renderTemplate(templatePath,{...ctx.config,projectName:ctx.projectName,title,today:ctx.today}),rendered=templatePath.startsWith("docs/skeletons/")?frontmatter(title,ctx.today)+body:body;return{result:writeFile(targetAbs,formatContent(rendered,targetAbs,ctx.repo),{skipIfExists:!bannerDetected,dryRun:ctx.dryRun}),targetRel}}export function generateDocSetSkeletons(config,opts={dryRun:!1}){const files=[],scaffolded=[],unbound=[],repo=config.targetDir,{payload}=runDocSet({repo,json:!0,quiet:!0,...opts.manifest!==void 0?{manifest:opts.manifest}:{},...opts.profile!==void 0?{profile:opts.profile}:{}});if(!payload)return{files,scaffolded,unbound};const ctx={repo,config,projectName:config.projectName??basename(resolve(repo)),today:isoToday(),tierColumn:payload.tierColumn,dryRun:opts.dryRun},rows=[...(payload.missing??[]).map(m=>({...m,isMissing:!0})),...(payload.present??[]).map(p=>({...p,isMissing:!1}))];for(const item of rows){const entry=item.template?SKELETON_CATALOG[item.template]:void 0;if(!entry){item.isMissing&&unbound.push(item.path);continue}const scaffoldedRow=scaffoldRow(item,entry,ctx);scaffoldedRow&&(files.push(scaffoldedRow.result),scaffolded.push({path:scaffoldedRow.targetRel,template:item.template,action:scaffoldedRow.result.action}))}return{files,scaffolded,unbound,tierColumn:payload.tierColumn}}export function runDocSetPlanApply(opts={}){const repo=opts.repo?resolve(opts.repo):process.cwd(),config={targetDir:repo,projectName:basename(repo)};return generateDocSetSkeletons(config,{dryRun:!opts.apply,...opts.manifest!==void 0?{manifest:opts.manifest}:{},...opts.profile!==void 0?{profile:opts.profile}:{}})}

package/dist/generators/docs.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{levelAtLeast}from"../config/levels.js";function emitSpecKitFamilies(config,opts){const base=config.targetDir,out=[];for(const steering of["structure","tech","product"])out.push(writeFile(resolvedPath(base,"docs","steering",`${steering}.md`),renderTemplate(`docs/steering/${steering}.md.ejs`,config),{skipIfExists:!0,dryRun:opts.dryRun}));out.push(writeFile(resolvedPath(base,"docs","specs","atomic-task-list.md"),renderTemplate("docs/specs/atomic-task-list.md.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}));for(const bug of["bug-report","bug-analysis","bug-verification"])out.push(writeFile(resolvedPath(base,"docs","bugs",`${bug}.md`),renderTemplate(`docs/bugs/${bug}.md.ejs`,config),{skipIfExists:!0,dryRun:opts.dryRun}));return out}function emitDocGenerationTools(config,opts){const base=config.targetDir;return[writeFile(resolvedPath(base,"scripts","gen-doc-index.mjs"),renderTemplate("scripts/gen-doc-index.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","gen-llms-txt.mjs"),renderTemplate("scripts/gen-llms-txt.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"llms-txt.config.json"),renderTemplate("llms-txt.config.json.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}export function generateDocs(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};const results=[],base=config.targetDir,data=config,adrDir=resolvedPath(base,join("docs","adr"));results.push(writeFile(join(adrDir,"ADR-000_template.md"),renderTemplate("docs/adr/ADR-000_template.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","SECURE_CODING_CHECKLIST.md"),renderTemplate("docs/SECURE_CODING_CHECKLIST.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","CODING_STANDARDS.md"),renderTemplate("docs/CODING_STANDARDS.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","MASTER_TEST_PLAN.md"),renderTemplate("docs/MASTER_TEST_PLAN.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","testing","POST_MERGE_REVIEW_TEMPLATE.md"),renderTemplate("docs/POST_MERGE_REVIEW_TEMPLATE.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),levelAtLeast(config.governanceLevel,"L3")&&results.push(writeFile(resolvedPath(base,"docs","SECURITY","ISO27001_ANNEX_A.md"),renderTemplate("docs/ISO27001_ANNEX_A.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","COMMANDS.md"),renderTemplate("documentation/cli-catalog.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const runbooksDir=resolvedPath(base,"docs","runbooks");for(const runbook of["rollback","troubleshooting","prod-checklist","deployment"])results.push(writeFile(resolvedPath(runbooksDir,`${runbook}.md`),renderTemplate(`docs/runbooks/${runbook}.md.ejs`,data),{skipIfExists:!0,dryRun:opts.dryRun}));return config.governanceLevel==="L3"&&results.push(writeFile(resolvedPath(base,"docs","SECURITY","RISK_ASSESSMENT.md"),renderTemplate("security/RISK_ASSESSMENT.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(...emitSpecKitFamilies(config,opts)),results.push(...emitDocGenerationTools(config,opts)),{files:results}}

package/dist/generators/duplication.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{injectDevDependency}from"../utils/pkg.js";function duplicationThresholdFor(level){return level==="L1"?10:level==="L2"?5:3}export function generateDuplication(config,opts={dryRun:!1}){if(config.language!=="typescript")return{files:[]};if(!config.enableDebtGates)return{files:[]};const data={...config,duplicationThreshold:duplicationThresholdFor(config.governanceLevel)},files=[writeFile(resolvedPath(config.targetDir,".jscpd.json"),renderTemplate("static-analysis/jscpd.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts/check-duplication.mjs"),renderTemplate("scripts/check-duplication.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun})];return injectDevDependency(config.targetDir,"jscpd","5.0.6",opts.dryRun),{files}}

package/dist/generators/e2e-constitution.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateE2eConstitution(config,opts={dryRun:!1}){if(!(config.archetype==="frontend-spa"||config.archetype==="backend-web-db"))return{files:[]};const constitution=renderTemplate("e2e/E2E_CONSTITUTION.md.ejs",config),base=config.targetDir;return{files:[writeFile(resolvedPath(base,"docs","GOVERNANCE","E2E_CONSTITUTION.md"),constitution,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/env-template.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateEnvTemplate(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data={projectName:config.projectName},envExamplePath=resolvedPath(base,".env.example");return results.push(writeFile(envExamplePath,renderTemplate("local-wrapper/.env.example.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/evidence-retention.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateEvidenceRetention(config,opts={dryRun:!1}){const base=config.targetDir,data={...config,evidenceRetention:config.evidenceRetention??{mode:"local-last-N",count:5}},files=[writeFile(resolvedPath(base,"scripts","evidence-rotate.mjs"),renderTemplate("scripts/evidence-rotate.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","evidence-prune.mjs"),renderTemplate("scripts/evidence-prune.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"docs","METHOD","EVIDENCE_RETENTION.md"),renderTemplate("governance/evidence-retention.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})];return config.enableEvidenceHarness!==!1&&files.push(writeFile(resolvedPath(base,"scripts","done-evidence.mjs"),renderTemplate("scripts/done-evidence.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","record-journey-evidence.mjs"),renderTemplate("scripts/record-journey-evidence.mjs.ejs",data),{skipIfExists:!1,backup:!0,dryRun:opts.dryRun})),config.governanceLevel==="L4"&&files.push(writeFile(resolvedPath(base,"evidence-files.json"),renderTemplate("evidence-files.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files}}

package/dist/generators/feature-matrix.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateFeatureMatrix(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};const base=config.targetDir,data=config,result=writeFile(resolvedPath(base,"docs","FEATURE_MATRIX.md"),renderTemplate("docs/FEATURE_MATRIX.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),gate=writeFile(resolvedPath(base,"scripts","check-feature-matrix.mjs"),renderTemplate("scripts/check-feature-matrix.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),schema=writeFile(resolvedPath(base,"schemas","rtm-verdict.schema.json"),renderTemplate("schemas/rtm-verdict.schema.json.ejs",data),{dryRun:opts.dryRun});return{files:[result,gate,schema]}}

package/dist/generators/frontend-governance.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateFrontendGovernance(config,opts={dryRun:!1}){if(!(config.archetype==="frontend-spa"||config.lanes.includes("frontend")))return{files:[]};const templateData={...config,frontend:config.frontend??{}},base=config.targetDir,constitution=renderTemplate("frontend/FRONTEND_CONSTITUTION.md.ejs",templateData),principles=renderTemplate("frontend/FE_DESIGN_PRINCIPLES.md.ejs",templateData);return{files:[writeFile(resolvedPath(base,"docs","GOVERNANCE","FRONTEND_CONSTITUTION.md"),constitution,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"docs","GOVERNANCE","FE_DESIGN_PRINCIPLES.md"),principles,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/frontend-quality.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{injectDevDependency}from"../utils/pkg.js";import{formatContent}from"../utils/prettier-format.js";export function generateFrontendQuality(config,opts={dryRun:!1}){if(!(config.archetype==="frontend-spa"||config.lanes.includes("frontend")))return{files:[]};const base=config.targetDir,templateData={...config,frontend:config.frontend??{}},tokensDef=renderTemplate("frontend/design-tokens.json.ejs",templateData),verifyTokens=renderTemplate("scripts/verify-tokens.mjs.ejs",templateData),i18nScanner=renderTemplate("scripts/i18n-literal-scanner.mjs.ejs",templateData),i18nParity=renderTemplate("scripts/verify-i18n-parity.mjs.ejs",templateData),feCoverage=renderTemplate("scripts/verify-fe-coverage.mjs.ejs",templateData),vitestBrowser=renderTemplate("coverage/vitest.browser.config.ts.ejs",templateData),vrtSetup=renderTemplate("frontend/vrt-setup.md.ejs",templateData),lighthouseRc=renderTemplate("perf/lighthouserc.json.ejs",templateData),bundleBudget=renderTemplate("perf/bundle-budget.json.ejs",templateData),checkBundleSize=renderTemplate("scripts/check-bundle-size.mjs.ejs",templateData),stylelintRc=renderTemplate("static-analysis/stylelintrc.json.ejs",templateData),renderSmokeSpec=config.language==="typescript"||config.language==="multi"?renderTemplate("e2e/playwright-ts/render-smoke.spec.ts.ejs",templateData):null,result={files:[writeFile(resolvedPath(base,"design-tokens.json"),tokensDef,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","verify-tokens.mjs"),verifyTokens,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","i18n-literal-scanner.mjs"),i18nScanner,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","verify-i18n-parity.mjs"),i18nParity,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","verify-fe-coverage.mjs"),feCoverage,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"vitest.browser.config.ts"),vitestBrowser,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"docs","GOVERNANCE","VRT_SETUP.md"),vrtSetup,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,".lighthouserc.json"),lighthouseRc,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"bundle-budget.json"),bundleBudget,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","check-bundle-size.mjs"),checkBundleSize,{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,".stylelintrc.json"),stylelintRc,{skipIfExists:!0,dryRun:opts.dryRun}),...renderSmokeSpec!==null?[(()=>{const renderSmokePath=resolvedPath(base,"tests","e2e","render-smoke.spec.ts");return writeFile(renderSmokePath,formatContent(renderSmokeSpec,renderSmokePath,base),{skipIfExists:!0,dryRun:opts.dryRun})})()]:[]]};return injectDevDependency(base,"stylelint","^16.0.0",opts.dryRun),result}

package/dist/generators/gap.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateGap(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};const base=config.targetDir,data=config,result=writeFile(resolvedPath(base,"docs","GAP.md"),renderTemplate("docs/GAP.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),gate=writeFile(resolvedPath(base,"scripts","gen-gap.mjs"),renderTemplate("scripts/gen-gap.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});return{files:[result,gate]}}

package/dist/generators/gdpr.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateGdprControls(config,opts={dryRun:!1}){const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun},docsDir="docs/compliance/gdpr";return[writeFile(resolvedPath(base,"scripts","check-gdpr-controls.mjs"),renderTemplate("audit/gdpr/check-gdpr-controls.mjs.ejs",data),skip),writeFile(resolvedPath(base,docsDir,"dpia.md"),renderTemplate("audit/gdpr/dpia.md.ejs",data),skip),writeFile(resolvedPath(base,docsDir,"data-flow-map.md"),renderTemplate("audit/gdpr/data-flow-map.md.ejs",data),skip),writeFile(resolvedPath(base,docsDir,"controls-to-gates.md"),renderTemplate("audit/gdpr/controls-to-gates.md.ejs",data),skip)]}

package/dist/generators/githooks.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{chmodTranslated,resolvedPath,writeFile}from"../utils/fs.js";import{mutatePackageJson}from"../utils/pkg.js";const HOOK_MODE=493;function writeHook(filePath,content,dryRun){const result=writeFile(filePath,content,{skipIfExists:!0,dryRun});return!dryRun&&result.action!=="skipped"&&chmodTranslated(filePath,HOOK_MODE),result}function isTypeScript(config){return config.language==="typescript"||config.language==="multi"}function injectPrepareScript(targetDir,dryRun){mutatePackageJson(targetDir,dryRun,pkg=>{const hooksCmd="git config core.hooksPath .githooks",scripts=pkg.scripts??{},existing=scripts.prepare??"";return existing.includes(hooksCmd)?!1:(scripts.prepare=existing?`${existing} && ${hooksCmd}`:hooksCmd,pkg.scripts=scripts,!0)})}export function generateGithooks(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data=config,hooksDir=resolvedPath(base,".githooks");if(results.push(writeHook(resolvedPath(hooksDir,"pre-commit"),renderTemplate("githooks/pre-commit.ejs",data),opts.dryRun)),results.push(writeHook(resolvedPath(hooksDir,"pre-push"),renderTemplate("githooks/pre-push.ejs",data),opts.dryRun)),results.push(writeHook(resolvedPath(hooksDir,"commit-msg"),renderTemplate("githooks/commit-msg.ejs",data),opts.dryRun)),isTypeScript(config))injectPrepareScript(base,opts.dryRun);else{const setupPath=resolvedPath(base,"scripts","setup-hooks.sh"),setupResult=writeFile(setupPath,renderTemplate("githooks/setup-hooks.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});!opts.dryRun&&setupResult.action!=="skipped"&&chmodTranslated(setupPath,HOOK_MODE),results.push(setupResult)}return{files:results}}

package/dist/generators/github-setup.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{chmodTranslated,resolvedPath,writeFile}from"../utils/fs.js";const SCRIPT_MODE=493;export function generateGithubSetup(config,opts={dryRun:!1}){if(!(config.permitGitHub??config.useGitHub))return{files:[]};const base=config.targetDir,data=config,files=[];if(config.governanceLevel!=="L1"){const setupScript=resolvedPath(base,"scripts","setup-repo.sh"),result=writeFile(setupScript,renderTemplate("scripts/setup-repo.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});!opts.dryRun&&result.action!=="skipped"&&chmodTranslated(setupScript,SCRIPT_MODE),files.push(result)}const bpScript=resolvedPath(base,"scripts","apply-branch-protection.mjs"),bpResult=writeFile(bpScript,renderTemplate("scripts/apply-branch-protection.mjs.ejs",data),{dryRun:opts.dryRun});!opts.dryRun&&bpResult.action!=="skipped"&&chmodTranslated(bpScript,SCRIPT_MODE),files.push(bpResult);for(const name of["check-ci-tiers.mjs","check-action-pins.mjs","check-workflow-perms.mjs","check-merge-method.mjs","ci-classify-changes.mjs"]){const scriptPath=resolvedPath(base,"scripts",name),result=writeFile(scriptPath,renderTemplate(`scripts/${name}.ejs`,data),{dryRun:opts.dryRun});!opts.dryRun&&result.action!=="skipped"&&chmodTranslated(scriptPath,SCRIPT_MODE),files.push(result)}return{files}}

package/dist/generators/github.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{levelAtLeast}from"../config/levels.js";import{resolvePipelineStyle,collaborationModeFromAnswers,resolveCollaborationMode,resolveDefaultBranchingStrategy}from"../config/collaboration-mode-defaults.js";import{isSubtreeFrontendLane}from"../detectors/lanes.js";export function resolveStyle(config){if(config.pipelineStyle)return config.pipelineStyle;if(config.collaborationMode)return resolvePipelineStyle(config.collaborationMode,config.governanceLevel);if(config.enableSoloDevMode){const mode=collaborationModeFromAnswers({soloDevMode:!0});return resolvePipelineStyle(mode,config.governanceLevel)}return config.ciTierMode==="baseline"?"starter":"standard"}export function releaseEnforcesMutation(config){return resolveStyle(config)!=="starter"}function generateIndustrialWorkflows(workflowsDir,data,dryRun){return[writeFile(join(workflowsDir,"12-mutation-scheduled.yml"),renderTemplate("github/workflows/12-mutation-scheduled.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"13-archunit-extended.yml"),renderTemplate("github/workflows/13-archunit-extended.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"14-license-scan.yml"),renderTemplate("github/workflows/14-license-scan.yml.ejs",data),{skipIfExists:!0,dryRun})]}const WEB_ARCHETYPES=new Set(["frontend-spa"]),PEER_REVIEW="peer-review",GATED_REVIEW="gated-review";function needsCodeql(cm,isL2Plus,language){return(cm===PEER_REVIEW&&isL2Plus||cm===GATED_REVIEW)&&language!=="rust"}function isReviewMode(cm){return cm===PEER_REVIEW||cm===GATED_REVIEW}function needsFrontendQuality(cm,isL2Plus,language,archetype){return isReviewMode(cm)&&isL2Plus&&language==="typescript"&&archetype!==void 0&&WEB_ARCHETYPES.has(archetype)}function needsFrontendLane(config,cm,isL2Plus){return isReviewMode(cm)&&isL2Plus&&isSubtreeFrontendLane(config)}function generateCiGapWorkflows(workflowsDir,config,dryRun){const files=[],cm=resolveCollaborationMode(config),gl=config.governanceLevel,isL2Plus=new Set(["L2","L3","L4"]).has(gl),isL3Plus=new Set(["L3","L4"]).has(gl);return cm==="trunk-solo"&&isL2Plus&&files.push(writeFile(join(workflowsDir,"06-nightly-lite.yml"),renderTemplate("github/workflows/06-nightly-lite.yml.ejs",config),{skipIfExists:!0,dryRun})),cm==="trunk-solo"&&isL3Plus&&files.push(writeFile(join(workflowsDir,"07-weekly-lite.yml"),renderTemplate("github/workflows/07-weekly-lite.yml.ejs",config),{skipIfExists:!0,dryRun})),needsCodeql(cm,isL2Plus,config.language)&&files.push(writeFile(join(workflowsDir,"15-codeql.yml"),renderTemplate("github/workflows/15-codeql.yml.ejs",config),{skipIfExists:!0,dryRun})),needsFrontendQuality(cm,isL2Plus,config.language,config.archetype)&&files.push(writeFile(join(workflowsDir,"16-frontend-quality.yml"),renderTemplate("github/workflows/16-frontend-quality.yml.ejs",config),{skipIfExists:!0,dryRun})),needsFrontendLane(config,cm,isL2Plus)&&files.push(writeFile(join(workflowsDir,"18-frontend-lane.yml"),renderTemplate("github/workflows/18-frontend-lane.yml.ejs",config),{skipIfExists:!0,dryRun})),cm===GATED_REVIEW&&isL3Plus&&files.push(writeFile(join(workflowsDir,"17-ossf-scorecard.yml"),renderTemplate("github/workflows/17-ossf-scorecard.yml.ejs",config),{skipIfExists:!0,dryRun})),files}function generateScheduledWorkflows(workflowsDir,data,dryRun){return[writeFile(join(workflowsDir,"_nightly.yml"),renderTemplate("github/workflows/_nightly.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_shared-security.yml"),renderTemplate("github/workflows/_shared-security.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_weekly.yml"),renderTemplate("github/workflows/_weekly.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_monthly.yml"),renderTemplate("github/workflows/_monthly.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"06-nightly.yml"),renderTemplate("github/workflows/06-nightly.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"07-weekly.yml"),renderTemplate("github/workflows/07-weekly.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"08-monthly.yml"),renderTemplate("github/workflows/08-monthly.yml.ejs",data),{skipIfExists:!0,dryRun})]}function generateCiWorkflows(workflowsDir,config,dryRun){const data=config,style=resolveStyle(config),cm=resolveCollaborationMode(config),files=[writeFile(join(workflowsDir,"01-pr-fast.yml"),renderTemplate("github/workflows/01-pr-fast.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"02-pr-extended.yml"),renderTemplate("github/workflows/02-pr-extended.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"03-human-approval.yml"),renderTemplate("github/workflows/03-human-approval.yml.ejs",data),{skipIfExists:!0,dryRun})];style!=="starter"&&files.push(writeFile(join(workflowsDir,"05-release.yml"),renderTemplate("github/workflows/05-release.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_sigstore-retry-sign.yml"),renderTemplate("github/workflows/_sigstore-retry-sign.yml.ejs",data),{skipIfExists:!0,dryRun}));const isL3Plus=levelAtLeast(config.governanceLevel,"L3");return style!=="starter"&&isL3Plus&&cm!=="trunk-solo"&&files.push(...generateScheduledWorkflows(workflowsDir,data,dryRun)),isL3Plus&&files.push(writeFile(join(workflowsDir,"09-heartbeat.yml"),renderTemplate("github/workflows/09-heartbeat.yml.ejs",data),{skipIfExists:!0,dryRun})),style==="industrial"&&files.push(...generateIndustrialWorkflows(workflowsDir,data,dryRun)),files.push(...generateCiGapWorkflows(workflowsDir,config,dryRun)),config.enableSoloDevMode&&files.push(writeFile(join(workflowsDir,"drift-shadow.yml"),renderTemplate("github/workflows/drift-shadow.yml.ejs",data),{skipIfExists:!0,dryRun})),(config.deployTarget??"none")!=="none"&&files.push(writeFile(join(workflowsDir,"04-deploy-test.yml"),renderTemplate("github/workflows/04-deploy-test.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"10-deploy-prod.yml"),renderTemplate("github/workflows/10-deploy-prod.yml.ejs",data),{skipIfExists:!0,dryRun})),files}function generateAgentGovernanceWorkflows(workflowsDir,config,dryRun){const data=config;return[writeFile(join(workflowsDir,"_label-on-approve.yml"),renderTemplate("github/workflows/_label-on-approve.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_ai-draft-check.yml"),renderTemplate("github/workflows/_ai-draft-check.yml.ejs",data),{skipIfExists:!0,dryRun}),writeFile(join(workflowsDir,"_pr-staleness.yml"),renderTemplate("github/workflows/_pr-staleness.yml.ejs",data),{skipIfExists:!0,dryRun})]}function generateIssueTemplates(issueTemplatesDir,config,dryRun){const data=config,files=[writeFile(join(issueTemplatesDir,"task-brief.yml"),renderTemplate("github/issue-templates/task-brief.yml.ejs",data),{skipIfExists:!0,dryRun})];for(const tpl of["bug-report.yml","feature-request.yml","epic.yml","config.yml"])files.push(writeFile(join(issueTemplatesDir,tpl),renderTemplate(`github/issue-templates/${tpl}`,data),{skipIfExists:!0,dryRun}));return config.governanceLevel!=="L1"&&files.push(writeFile(join(issueTemplatesDir,"compliance-item.yml"),renderTemplate("github/issue-templates/compliance-item.yml.ejs",data),{skipIfExists:!0,dryRun})),files}function resolveBranchingStrategy(config){return config.branchingStrategy?config.branchingStrategy:config.collaborationMode?resolveDefaultBranchingStrategy(config.collaborationMode):config.enableSoloDevMode?"trunk-direct":"github-flow"}export function generateGithub(config,opts={dryRun:!1}){const data={...config,branchingStrategy:resolveBranchingStrategy(config)},githubDir=resolvedPath(config.targetDir,".github"),workflowsDir=join(githubDir,"workflows"),issueTemplatesDir=join(githubDir,"ISSUE_TEMPLATE"),actionsDir=join(githubDir,"actions");return{files:[...generateCiWorkflows(workflowsDir,data,opts.dryRun),...generateAgentGovernanceWorkflows(workflowsDir,data,opts.dryRun),writeFile(join(githubDir,"PULL_REQUEST_TEMPLATE.md"),renderTemplate("github/PULL_REQUEST_TEMPLATE.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(githubDir,"extended-ci-paths.txt"),renderTemplate("github/extended-ci-paths.txt.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),...generateIssueTemplates(issueTemplatesDir,data,opts.dryRun),writeFile(join(workflowsDir,"issue-state.yml"),renderTemplate("github/workflows/issue-state.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(githubDir,"dependabot.yml"),renderTemplate("github/dependabot.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(join(actionsDir,"sign-and-attest","action.yml"),renderTemplate("github/actions/sign-and-attest/action.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/gitignore.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateGitignore(config,opts={dryRun:!1}){const base=config.targetDir,data={...config,evidenceRetention:config.evidenceRetention??{mode:"local-last-N",count:5}};return{files:[writeFile(resolvedPath(base,".gitignore"),renderTemplate("root/.gitignore.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/global-invariants.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{getFilteredInvariants,getInvariantsByTier}from"../invariants/filter.js";import{TIER_LABELS}from"../invariants/tiers.js";const OPTIONAL_TIERS=["data","security","operational"];export function generateGlobalInvariants(config,opts={dryRun:!1}){if(!config.invariantTiers.some(t=>OPTIONAL_TIERS.includes(t)))return{action:"skipped",reason:"not-applicable",path:resolvedPath(config.targetDir,"GLOBAL_INVARIANTS.md")};const invariants=getFilteredInvariants({language:config.language,governanceLevel:config.governanceLevel,invariantTiers:config.invariantTiers,...config.includeExtendedInvariants?{includeExtendedInvariants:!0}:{},...config.projectInvariants!==void 0?{projectInvariants:config.projectInvariants}:{}}),invariantsByTier=getInvariantsByTier(invariants),data={...config,invariants,invariantsByTier,tierLabels:TIER_LABELS},content=renderTemplate("global-invariants/GLOBAL_INVARIANTS.md.ejs",data).trimEnd()+`
+`;return writeFile(resolvedPath(config.targetDir,"GLOBAL_INVARIANTS.md"),content,{backup:!0,dryRun:opts.dryRun})}

package/dist/generators/go-boundaries.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateGoBoundaries(config,opts={dryRun:!1}){if(config.language!=="go")return{files:[]};if(config.architectureStyle!=="hexagonal")return{files:[]};const base=config.targetDir,data=config;return{files:[writeFile(resolvedPath(base,".golangci-boundaries.yml"),renderTemplate("boundaries/golangci-boundaries.yml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts/check-boundaries.mjs"),renderTemplate("boundaries/check-boundaries-go.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/gold-kit.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{writeFile,resolvedPath}from"../utils/fs.js";import{renderTemplate}from"../utils/render.js";const PER_STACK_REGISTRY={typescript:"gold-registry.typescript.yml",java:"gold-registry.java.yml",kotlin:"gold-registry.java.yml"},STANDARDS=[{rel:"gold-registry.yml",tpl:"standards/gold-registry.yml.ejs"},{rel:"thresholds.yml",tpl:"standards/thresholds.yml.ejs"},{rel:"gold-doc-set.yml",tpl:"standards/gold-doc-set.yml.ejs"},{rel:"doc-profile",tpl:"standards/doc-profile.ejs"}];export function generateGoldKit(config,opts={dryRun:!1}){const base=config.targetDir,files=[];files.push(writeFile(resolvedPath(base,"scripts","gold-audit.mjs"),renderTemplate("scripts/gold-audit.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}));for(const{rel,tpl}of STANDARDS)files.push(writeFile(resolvedPath(base,"standards",rel),renderTemplate(tpl,config),{skipIfExists:!0,dryRun:opts.dryRun}));const stackTpl=PER_STACK_REGISTRY[config.language];return stackTpl&&files.push(writeFile(resolvedPath(base,"standards",stackTpl.replace(/\.ejs$/,"")),renderTemplate(`standards/${stackTpl}.ejs`,config),{skipIfExists:!0,dryRun:opts.dryRun})),{files}}

package/dist/generators/infra.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{chmodTranslated,writeFile,resolvedPath}from"../utils/fs.js";const SCRIPT_MODE=493;export function generateInfra(config,opts={dryRun:!1}){if(config.deployTarget==="azure-container-app"){const infraDir=resolvedPath(config.targetDir,"infra","azure");return{files:[writeFile(join(infraDir,"containerapp.tpl.yaml"),renderTemplate("infra/azure/containerapp.tpl.yaml.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}}if(config.deployTarget==="nas-compose"){const infraDir=resolvedPath(config.targetDir,"infra","nas-compose"),scriptPath=join(infraDir,"deploy.sh"),scriptResult=writeFile(scriptPath,renderTemplate("infra/nas-compose/deploy.sh.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun});return!opts.dryRun&&scriptResult.action!=="skipped"&&chmodTranslated(scriptPath,SCRIPT_MODE),{files:[scriptResult]}}return{files:[]}}

package/dist/generators/integration-testing.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync}from"node:fs";import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{resolvedPath,writeFile,writeFileTranslated,readFileTranslated}from"../utils/fs.js";import{formatContent}from"../utils/prettier-format.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";function appendCargoDevDep(base,name,version,dryRun){if(dryRun)return;const cargoPath=join(base,"Cargo.toml");if(!existsSync(cargoPath))return;const content=readFileTranslated(cargoPath,"utf-8");if(content.includes(name))return;const section="[dev-dependencies]",entry=`${name} = "${version}"
+`;content.includes(section)?writeFileTranslated(cargoPath,content.replace(section,`${section}
+${entry}`)):writeFileTranslated(cargoPath,`${content.trimEnd()}
+
+${section}
+${entry}`)}function emitJavaIntegrationTesting(config,base,data,dryRun){const supportPkg=config.basePackage?`src/test/java/${config.basePackage.replace(/\./g,"/")}/support`:"src/test/java/support",results=[writeFile(resolvedPath(base,supportPkg,"AbstractIntegrationTest.java"),renderTemplate("integration-testing/AbstractIntegrationTest.java.ejs",data),{skipIfExists:!0,dryRun}),writeFile(resolvedPath(base,supportPkg,"NoH2ArchTest.java"),renderTemplate("integration-testing/NoH2ArchTest.java.ejs",data),{skipIfExists:!0,dryRun}),writeFile(resolvedPath(base,"config","testcontainers-deps.gradle"),renderTemplate("integration-testing/testcontainers-deps.gradle.ejs",data),{skipIfExists:!0,dryRun})];if(config.buildTool==="gradle"){const applyTestcontainers=safeApplyFromSnippet(base,"config/testcontainers-deps.gradle");applyTestcontainers&&injectGradleWiring(base,dryRun,{snippets:[applyTestcontainers]})}return results}export function generateIntegrationTesting(config,opts={dryRun:!1}){if(!(config.databaseEngine!=null?config.databaseEngine!=="none":config.hasDatabase)||config.governanceLevel==="L1")return{files:[]};const base=config.targetDir,data=config,results=[];if((config.language==="java"||config.language==="multi")&&results.push(...emitJavaIntegrationTesting(config,base,data,opts.dryRun)),config.language==="typescript"||config.language==="multi"){const testSetupPath=resolvedPath(base,"__tests__","integrations","test-setup.ts");results.push(writeFile(testSetupPath,formatContent(renderTemplate("integration-testing/test-setup.ts.ejs",data),testSetupPath,base),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,".eslintrc-no-fake-db.json"),renderTemplate("integration-testing/eslint-no-fake-db.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const noFakeDbConfigPath=resolvedPath(base,"eslint.config.no-fake-db.mjs");results.push(writeFile(noFakeDbConfigPath,formatContent(renderTemplate("integration-testing/eslint.config.no-fake-db.mjs.ejs",data),noFakeDbConfigPath,base),{skipIfExists:!0,dryRun:opts.dryRun}))}if(config.language==="rust")results.push(writeFile(resolvedPath(base,"tests","db_fixture.rs"),renderTemplate("integration-testing/db_fixture.rs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),appendCargoDevDep(base,"testcontainers","0.23",opts.dryRun);else if(config.language==="go"){const goTemplate=config.databaseEngine==="sqlite"?"integration-testing/main_test_sqlite.go.ejs":"integration-testing/main_test.go.ejs";results.push(writeFile(resolvedPath(base,"tests","main_test.go"),renderTemplate(goTemplate,data),{skipIfExists:!0,dryRun:opts.dryRun}))}else config.language==="python"&&results.push(writeFile(resolvedPath(base,"tests","conftest.py"),renderTemplate("integration-testing/conftest.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));return{files:results}}

package/dist/generators/iso27001.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateIso27001(config,opts={dryRun:!1}){if(config.industryOverlay!=="iso27001")return{files:[]};const skip={skipIfExists:!0,dryRun:opts.dryRun};return{files:[writeFile(resolvedPath(config.targetDir,"docs/compliance","iso27001-controls-gate-map.md"),renderTemplate("audit/iso27001/iso27001-controls-gate-map.md.ejs",config),skip)]}}

package/dist/generators/iso9001.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateIso9001(config,opts={dryRun:!1}){if(config.industryOverlay!=="iso9001")return{files:[]};const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun},qualityDir="docs/quality";return{files:[writeFile(resolvedPath(base,qualityDir,"REQUIREMENTS_TRACEABILITY.md"),renderTemplate("quality/iso9001/REQUIREMENTS_TRACEABILITY.md.ejs",data),skip),writeFile(resolvedPath(base,qualityDir,"DOCUMENT_CONTROL.md"),renderTemplate("quality/iso9001/DOCUMENT_CONTROL.md.ejs",data),skip),writeFile(resolvedPath(base,qualityDir,"CAPA_LOG.md"),renderTemplate("quality/iso9001/CAPA_LOG.md.ejs",data),skip),writeFile(resolvedPath(base,"scripts","check-iso9001.mjs"),renderTemplate("scripts/check-iso9001.mjs.ejs",data),skip)]}}

package/dist/generators/labels.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+export const TASK_SIZE_LABELS=[{name:"size:XS",description:"Tiny task \u2014 single file, minimal plan, 1 review agent",color:"c2e0c6"},{name:"size:S",description:"Small task \u2014 2\u20135 files, brief plan, 1 review agent",color:"fef2c0"},{name:"size:Standard",description:"Standard task \u2014 multi-file, full plan, 2 review agents",color:"fbca04"}];

package/dist/generators/local-wrapper.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{chmodTranslated,resolvedPath,unlinkTranslated,writeFile}from"../utils/fs.js";export function generateLocalWrapper(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data={projectName:config.projectName,enableEvidenceHarness:config.enableEvidenceHarness},makefilePath=resolvedPath(base,"Makefile");results.push(writeFile(makefilePath,renderTemplate("local-wrapper/Makefile.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const runShPath=resolvedPath(base,"run.sh"),runShResult=writeFile(runShPath,renderTemplate("local-wrapper/run.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});if(results.push(runShResult),!opts.dryRun&&runShResult.action!=="skipped")try{chmodTranslated(runShPath,493)}catch(err){try{unlinkTranslated(runShPath)}catch{}throw new Error(`chmod run.sh failed: ${err.message}. File removed to avoid partial state.`,{cause:err})}return{files:results}}

package/dist/generators/modulith.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{readFileSync,existsSync}from"node:fs";import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";function isSpringBootProject(targetDir){const pomPath=join(targetDir,"pom.xml");if(existsSync(pomPath))try{return readFileSync(pomPath,"utf8").includes("spring-boot-starter")}catch{return!1}const gradlePath=join(targetDir,"build.gradle"),gradleKtsPath=join(targetDir,"build.gradle.kts");for(const gPath of[gradlePath,gradleKtsPath])if(existsSync(gPath))try{if(readFileSync(gPath,"utf8").includes("spring-boot"))return!0}catch{continue}return!1}export function generateModulith(config,opts={dryRun:!1}){if(config.language!=="java"&&config.language!=="kotlin"&&config.language!=="multi")return{files:[]};if(!(isSpringBootProject(config.targetDir)||config.kitEnabled===!0))return{files:[]};const packagePath=config.basePackage?config.basePackage.replace(/\./g,"/")+"/modulith":"modulith",data={...config,basePackage:config.basePackage??"com.example"},files=[writeFile(resolvedPath(config.targetDir,"src","test","java",packagePath,"ApplicationModulesTest.java"),renderTemplate("java/modulith/ApplicationModulesTest.java.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})];return files.push(...emitAndWireModulithDeps(config,data,opts.dryRun)),{files}}function emitAndWireModulithDeps(config,data,dryRun){const base=config.targetDir;if(config.buildTool==="gradle"){const result=writeFile(resolvedPath(base,"gradle","modulith-deps.gradle"),renderTemplate("java/modulith/modulith-deps.gradle.ejs",data),{skipIfExists:!0,dryRun}),apply=safeApplyFromSnippet(base,"gradle/modulith-deps.gradle");return apply&&injectGradleWiring(base,dryRun,{snippets:[apply]}),[result]}return config.buildTool==="maven"?[writeFile(resolvedPath(base,"docs","modulith-maven-setup.md"),renderTemplate("java/modulith/modulith-maven-setup.md.ejs",data),{skipIfExists:!0,dryRun})]:[]}

package/dist/generators/mutation.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{injectGradleWiring,safeApplyFromSnippet}from"../utils/gradle.js";import{resolveEffectiveThresholds}from"../config/thresholds.js";import{isL3Allowed}from"../utils/maturity-check.js";import{levelAtLeast}from"../config/levels.js";import{releaseEnforcesMutation}from"./github.js";const PITEST_PLUGIN_VERSION="1.15.0";function shouldEmit(target,language,acceptBeta){return language===target?!0:language!=="multi"?!1:isL3Allowed(target,"mutation",acceptBeta).allowed}function emitJavaMutation(targetDir,buildTool,data,dryRun){if(buildTool==="maven")return writeFile(resolvedPath(targetDir,"docs","mutation","pitest-maven-setup.md"),renderTemplate("mutation/pitest-maven-setup.md.ejs",data),{skipIfExists:!0,dryRun});const result=writeFile(resolvedPath(targetDir,"gradle","pitest.gradle"),renderTemplate("mutation/pitest.gradle.ejs",data),{skipIfExists:!0,dryRun}),apply=safeApplyFromSnippet(targetDir,"gradle/pitest.gradle");return injectGradleWiring(targetDir,dryRun,{plugins:[{id:"info.solidsoft.pitest",version:PITEST_PLUGIN_VERSION}],snippets:apply?[apply]:[]}),result}export function generateMutation(config,opts={dryRun:!1}){if(!levelAtLeast(config.governanceLevel,"L3")&&!releaseEnforcesMutation(config))return{files:[]};const{language,targetDir,acceptBetaTools=!1}=config;if(language!=="multi"&&!isL3Allowed(language,"mutation",acceptBetaTools).allowed)return{files:[]};const data={...config,mutationThreshold:resolveEffectiveThresholds(config).mutationScore,basePackage:config.basePackage??"com.example",modulePath:config.projectName.replace(/-/g,"_")},files=[writeFile(resolvedPath(targetDir,"docs","mutation","README.md"),renderTemplate("mutation/README.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})];return shouldEmit("java",language,acceptBetaTools)&&files.push(emitJavaMutation(targetDir,config.buildTool,data,opts.dryRun)),shouldEmit("typescript",language,acceptBetaTools)&&files.push(writeFile(resolvedPath(targetDir,"stryker.conf.json"),renderTemplate("mutation/stryker.conf.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),language==="rust"?files.push(writeFile(resolvedPath(targetDir,"cargo-mutants.toml"),renderTemplate("mutation/cargo-mutants.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(targetDir,"scripts","parse-mutants.mjs"),renderTemplate("mutation/parse-mutants.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})):language==="python"&&files.push(writeFile(resolvedPath(targetDir,"mutmut-config.toml"),renderTemplate("mutation/mutmut-config.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(targetDir,"scripts","parse-mutmut.py"),renderTemplate("mutation/parse-mutmut.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files}}

package/dist/generators/observability.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateObservability(config,opts={dryRun:!1}){return!config.observability||config.observability.provider==="none"?{files:[]}:{files:[writeFile(resolvedPath(config.targetDir,"docs","OBSERVABILITY.md"),renderTemplate("observability/setup.md.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/operations.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateOperations(config,opts={dryRun:!1}){const path=resolvedPath(config.targetDir,"docs","OPERATIONS_HANDBOOK.md"),content=renderTemplate("operations/handbook.md.ejs",config);return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/perf-k6.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";const SCENARIO_NAMES=["load","stress","spike","soak","volume","breakpoint","smoke","ramp-up","ramp-down","steady-state","burst","endurance"],REPORT_NAMES=["html-report","json-report","csv-report"];export function generatePerfK6(config,opts={dryRun:!1}){if(!config.enablePerfTesting)return{files:[]};const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun},workflowsDir=resolvedPath(base,".github","workflows"),scenariosDir=resolvedPath(base,"perf","k6","scenarios"),reportsDir=resolvedPath(base,"perf","k6","reports"),seedDir=resolvedPath(base,"perf","k6","seed"),scriptsDir=resolvedPath(base,"scripts"),files=[];files.push(writeFile(join(workflowsDir,"11-k6-on-demand.yml"),renderTemplate("github/workflows/11-k6-on-demand.yml.ejs",data),skip)),files.push(writeFile(join(workflowsDir,"_k6-runner.yml"),renderTemplate("github/workflows/_k6-runner.yml.ejs",data),skip));for(const name of SCENARIO_NAMES)files.push(writeFile(join(scenariosDir,`${name}.js`),renderTemplate(`perf/k6/scenarios/${name}.js.ejs`,data),skip));for(const name of REPORT_NAMES)files.push(writeFile(join(reportsDir,`${name}.py`),renderTemplate(`perf/k6/reports/${name}.py.ejs`,data),skip));return files.push(writeFile(join(seedDir,"test-data.sql"),renderTemplate("perf/k6/seed/test-data.sql.ejs",data),skip)),files.push(writeFile(join(scriptsDir,"validate-k6-scenarios.mjs"),renderTemplate("scripts/validate-k6-scenarios.mjs.ejs",data),skip)),{files}}

package/dist/generators/pharma.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{generateGdprControls}from"./gdpr.js";function auditMainPkg(config){return config.basePackage?`src/main/java/${config.basePackage.replace(/\./g,"/")}/audit`:"src/main/java/audit"}function archTestPkg(config){return config.basePackage?`src/test/java/${config.basePackage.replace(/\./g,"/")}/architecture`:"src/test/java/architecture"}function generatePharmaJava(config,opts){if(config.language!=="java")return[];const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun},mainPkg=auditMainPkg(config),testPkg=archTestPkg(config);return[writeFile(resolvedPath(base,mainPkg,"AuditEvent.java"),renderTemplate("java/pharma/AuditEvent.java.ejs",data),skip),writeFile(resolvedPath(base,mainPkg,"AuditMapper.java"),renderTemplate("java/pharma/AuditMapper.java.ejs",data),skip),writeFile(resolvedPath(base,testPkg,"PharmaArchUnitTest.java"),renderTemplate("java/pharma/archunit-pharma.ejs",data),skip)]}function generateGenericAudit(config,opts){const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun};return[writeFile(resolvedPath(base,"docs/compliance","audit-trail-policy.md"),renderTemplate("audit/generic/audit-trail-policy.md.ejs",data),skip),writeFile(resolvedPath(base,"docs/compliance","audit-gate-rules.md"),renderTemplate("audit/generic/audit-gate-rules.md.ejs",data),skip)]}export function generatePharma(config,opts={dryRun:!1}){const overlay=config.industryOverlay;if(!overlay||overlay==="none")return{files:[]};if(overlay==="iso9001")return{files:[]};let files;return overlay==="pharma"?files=generatePharmaJava(config,opts):overlay==="gdpr"?files=[...generateGenericAudit(config,opts),...generateGdprControls(config,opts)]:files=generateGenericAudit(config,opts),{files}}

package/dist/generators/playwright-python.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";const E2E_ARCHETYPES=new Set(["frontend-spa","backend-web-db"]);export function generatePlaywrightPython(config,opts={dryRun:!1}){if(config.language!=="python")return{files:[]};if(!E2E_ARCHETYPES.has(config.archetype))return{files:[]};const base=config.targetDir,data=config;return{files:[writeFile(resolvedPath(base,"tests","e2e","conftest.py"),renderTemplate("e2e/playwright-python/conftest.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"tests","e2e","test_smoke.py"),renderTemplate("e2e/playwright-python/test_smoke.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"tests","e2e","a11y","__init__.py"),"",{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"tests","e2e","a11y","run_axe.py"),renderTemplate("e2e/playwright-python/run_axe.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"tests","e2e","test_a11y.py"),renderTemplate("e2e/playwright-python/test_a11y.py.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/playwright-ts.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";import{formatContent}from"../utils/prettier-format.js";const A11Y_ARCHETYPES=new Set(["frontend-spa","backend-web-db"]);export function generatePlaywrightTs(config,opts={dryRun:!1}){if(config.language!=="typescript"&&config.language!=="multi")return{files:[]};if(!A11Y_ARCHETYPES.has(config.archetype))return{files:[]};const base=config.targetDir,runAxePath=resolvedPath(base,"tests","e2e","a11y","run-axe.ts"),a11ySpecPath=resolvedPath(base,"tests","e2e","a11y.spec.ts");return{files:[writeFile(runAxePath,formatContent(renderTemplate("e2e/playwright-ts/run-axe.ts.ejs",config),runAxePath,base),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(a11ySpecPath,formatContent(renderTemplate("e2e/playwright-ts/a11y.spec.ts.ejs",config),a11ySpecPath,base),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/pr-tooling.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{chmodTranslated,resolvedPath,writeFile}from"../utils/fs.js";import{renderTemplate}from"../utils/render.js";const SCRIPT_MODE=493;export function generatePrTooling(config,opts={dryRun:!1}){const files=[writeFile(resolvedPath(config.targetDir,"scripts","lib","exact-sha-policy.mjs"),renderTemplate("scripts/lib/exact-sha-policy.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts","lib","waiter-count.mjs"),renderTemplate("scripts/lib/waiter-count.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts","pr-merge-watch.mjs"),renderTemplate("scripts/pr-merge-watch.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts","capacity-probe.mjs"),renderTemplate("scripts/capacity-probe.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts","bg-run.sh"),renderTemplate("scripts/bg-run.sh.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(config.targetDir,"scripts","pid-watch.sh"),renderTemplate("scripts/pid-watch.sh.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})];if(!opts.dryRun)for(const rel of["scripts/bg-run.sh","scripts/pid-watch.sh"]){const scriptPath=resolvedPath(config.targetDir,rel);chmodTranslated(scriptPath,SCRIPT_MODE)}return{files}}

package/dist/generators/python-boundaries.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generatePythonBoundaries(config,opts={dryRun:!1}){if(config.language!=="python")return{files:[]};if(config.architectureStyle!=="hexagonal")return{files:[]};const base=config.targetDir,data=config;return{files:[writeFile(resolvedPath(base,".importlinter"),renderTemplate("boundaries/.importlinter.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"ruff-boundaries.toml"),renderTemplate("boundaries/ruff-boundaries.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts/check-boundaries.mjs"),renderTemplate("boundaries/check-boundaries-python.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/quality.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";const SONAR_SUPPORTED_LANGUAGES=new Set(["java","typescript","kotlin"]);export function generateQuality(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};if(!SONAR_SUPPORTED_LANGUAGES.has(config.language))return{files:[]};const base=config.targetDir,data=config;return{files:[writeFile(resolvedPath(base,"sonar-project.properties"),renderTemplate("sonar-project.properties.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}