@getarbiter/cli 0.5.0

package/dist/generators/registry.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{levelAtLeast}from"../config/levels.js";import{getLogger}from"../utils/logger.js";import{generateAgentsMd}from"./agents-md.js";import{computeSkipReport}from"./skills.js";import{generateClaude}from"./claude.js";import{generateCodex}from"./codex.js";import{generateGithub}from"./github.js";import{generateRoot}from"./root.js";import{generateCheckAll}from"./check-all.js";import{generateAntiProforma}from"./anti-proforma.js";import{generateCommitFooter}from"./commit-footer.js";import{generateStackConformity}from"./check-stack-conformity.js";import{generateCoverage}from"./coverage.js";import{generateDuplication}from"./duplication.js";import{generateDebtGates}from"./debt-gates.js";import{generateDebtRatchet}from"./debt-ratchet.js";import{generateSuppressions}from"./suppressions.js";import{generateSecurity}from"./security.js";import{generateStrideEnforcement}from"./stride-enforcement.js";import{generateEvidenceRetention}from"./evidence-retention.js";import{generateGitignore}from"./gitignore.js";import{generateTestTaxonomy}from"./test-taxonomy.js";import{generateArchUnit}from"./archunit.js";import{generateQuality}from"./quality.js";import{generateEslintBoundaries}from"./boundaries.js";import{generateRustBoundaries}from"./rust-boundaries.js";import{generateGoBoundaries}from"./go-boundaries.js";import{generatePythonBoundaries}from"./python-boundaries.js";import{generateMutation}from"./mutation.js";import{generateIntegrationTesting}from"./integration-testing.js";import{generateContractTesting}from"./contract-testing.js";import{generateGlobalInvariants}from"./global-invariants.js";import{generateSkills}from"./skills.js";import{generateAgentsClaude}from"./agents-claude.js";import{generateSsot}from"./ssot.js";import{generateAntiDriftValidators}from"./anti-drift-validators.js";import{generateBehavioralTests}from"./behavioral-tests.js";import{generatePlaywrightPython}from"./playwright-python.js";import{generatePlaywrightTs}from"./playwright-ts.js";import{generateE2eConstitution}from"./e2e-constitution.js";import{generateGithooks}from"./githooks.js";import{generateShipDriver}from"./ship-driver.js";import{generateGithubSetup}from"./github-setup.js";import{generateDocs}from"./docs.js";import{generateApiMiddleware}from"./api-middleware.js";import{generateSeed}from"./seed.js";import{generateSelfValidation}from"./self-validation.js";import{generateOperations}from"./operations.js";import{generateFrontendGovernance}from"./frontend-governance.js";import{generateFrontendQuality}from"./frontend-quality.js";import{generateRiskRegister}from"./risk-register.js";import{generateCompliance}from"./compliance.js";import{generateComplianceMenu}from"./compliance-menu.js";import{generatePharma}from"./pharma.js";import{generateIso27001}from"./iso27001.js";import{generateIso9001}from"./iso9001.js";import{generateRegulated}from"./regulated.js";import{generateObservability}from"./observability.js";import{generateAuth}from"./auth.js";import{generateCiTier}from"./ci-tier.js";import{generateCiFiveLane}from"./ci-five-lane.js";import{generateLocalWrapper}from"./local-wrapper.js";import{generateEnvTemplate}from"./env-template.js";import{generateInfra}from"./infra.js";import{generateAuditToolchain}from"./audit-toolchain.js";import{generatePerfK6}from"./perf-k6.js";import{generateModulith}from"./modulith.js";import{generateFeatureMatrix}from"./feature-matrix.js";import{generateGap}from"./gap.js";import{generateResilience}from"./resilience.js";import{generateTestPyramidManifest}from"./test-pyramid-manifest.js";import{generateApiE2e}from"./api-e2e.js";import{generateSmokeJourneys}from"./smoke-journeys.js";import{generateSoloException}from"./solo-exception.js";import{generateWiki}from"./wiki.js";import{generatePrTooling}from"./pr-tooling.js";import{generateConformanceScript}from"./conformance.js";import{generateGoldKit}from"./gold-kit.js";import{generateDocSetSkeletons}from"./doc-set.js";const BACKEND_WEB_DB="backend-web-db";function buildAiToolSpecs(config,installedSkills){const noAiRulez=!config.existing.aiRulez,skipReport=computeSkipReport(installedSkills);return[{key:"agents-md",enabled:!0,run:opts=>[generateAgentsMd(config,installedSkills,skipReport,opts)]},{key:"global-invariants",enabled:!0,run:opts=>[generateGlobalInvariants(config,opts)]},{key:"baseline-gitignore",enabled:!0,run:opts=>generateGitignore(config,opts).files},{key:"claude",enabled:noAiRulez&&config.tools.includes("claude"),run:opts=>generateClaude(config,opts).files},{key:"codex",enabled:noAiRulez&&config.tools.includes("codex"),run:opts=>generateCodex(config,opts).files},{key:"skills",enabled:noAiRulez,run:opts=>generateSkills(config,installedSkills,opts).files},{key:"agents-claude",enabled:noAiRulez,run:opts=>generateAgentsClaude(config,opts).files}]}function buildGateScriptSpecs(config){return[{key:"anti-proforma",enabled:!0,run:opts=>generateAntiProforma(config,opts).files},{key:"commit-footer-rationale",enabled:config.governanceLevel!=="L1",run:opts=>generateCommitFooter(config,opts).files},{key:"stack-conformity",enabled:!!config.language,run:opts=>generateStackConformity(config,opts).files},{key:"test-pyramid",enabled:!0,run:opts=>generateTestPyramidManifest(config,opts).files},{key:"api-e2e",enabled:!0,run:opts=>generateApiE2e(config,opts).files},{key:"smoke-journeys",enabled:!0,run:opts=>generateSmokeJourneys(config,opts).files}]}function buildInfraSpecs(config){return[{key:"github",enabled:(config.permitGitHub??config.useGitHub)&&!config.enableFiveLaneCi,run:opts=>generateGithub(config,opts).files},{key:"root",enabled:!0,run:opts=>generateRoot(config,opts).files},{key:"check-all",enabled:!0,run:opts=>generateCheckAll(config,opts).files},...buildGateScriptSpecs(config),{key:"debt-gates",enabled:!0,run:opts=>generateDebtGates(config,opts).files},{key:"debt-ratchet",enabled:config.enableDebtGates,run:opts=>generateDebtRatchet(config,opts).files},{key:"coverage",enabled:config.enableDebtGates,run:opts=>generateCoverage(config,opts).files},{key:"duplication",enabled:config.enableDebtGates,run:opts=>generateDuplication(config,opts).files},{key:"suppressions",enabled:!0,run:opts=>generateSuppressions(config,opts).files},{key:"security",enabled:!0,run:opts=>generateSecurity(config,opts).files},{key:"stride-enforcement",enabled:config.enableDebtGates,run:opts=>generateStrideEnforcement(config,opts).files},{key:"githooks",enabled:!0,run:opts=>generateGithooks(config,opts).files},{key:"ship-driver",enabled:config.tools.includes("claude"),run:opts=>generateShipDriver(config,opts).files},{key:"github-setup",enabled:(config.permitGitHub??config.useGitHub)&&config.governanceLevel!=="L1",run:opts=>generateGithubSetup(config,opts).files},{key:"docs",enabled:config.governanceLevel!=="L1",run:opts=>generateDocs(config,opts).files},{key:"quality",enabled:config.governanceLevel!=="L1",run:opts=>generateQuality(config,opts).files},{key:"api-middleware",enabled:config.hasPublicApi,run:opts=>generateApiMiddleware(config,opts).files},{key:"self-validation",enabled:config.enableSelfValidationHarness!==!1,run:opts=>generateSelfValidation(config,opts).files},{key:"infra",enabled:config.deployTarget==="azure-container-app"||config.deployTarget==="nas-compose",run:opts=>generateInfra(config,opts).files}]}function buildBackendServiceSpecs(config){const enabled=config.archetype===BACKEND_WEB_DB&&config.governanceLevel!=="L1";return[{key:"seed",enabled,run:opts=>generateSeed(config,opts).files},{key:"resilience",enabled,run:opts=>generateResilience(config,opts).files}]}function buildBoundarySpecs(config){return[{key:"archunit",enabled:!0,run:opts=>generateArchUnit(config,opts).files},{key:"eslint-boundaries",enabled:!0,run:opts=>generateEslintBoundaries(config,opts).files},{key:"rust-boundaries",enabled:!0,run:opts=>generateRustBoundaries(config,opts).files},{key:"go-boundaries",enabled:!0,run:opts=>generateGoBoundaries(config,opts).files},{key:"python-boundaries",enabled:!0,run:opts=>generatePythonBoundaries(config,opts).files},{key:"modulith",enabled:config.language==="java"||config.language==="kotlin"||config.language==="multi",run:opts=>generateModulith(config,opts).files}]}function buildGovernanceOverlaySpecs(config){return[{key:"risk-register",enabled:config.enableRiskRegister===!0,run:opts=>generateRiskRegister(config,opts).files},{key:"compliance",enabled:config.enableIso27001Mapping===!0||config.enableNis2Mapping===!0||config.enableGdprMapping===!0,run:opts=>generateCompliance(config,opts).files},{key:"pharma",enabled:config.industryOverlay!=null&&config.industryOverlay!=="none",run:opts=>generatePharma(config,opts).files},{key:"iso27001-controls",enabled:config.industryOverlay==="iso27001",run:opts=>generateIso27001(config,opts).files},{key:"iso9001",enabled:config.industryOverlay==="iso9001",run:opts=>generateIso9001(config,opts).files},{key:"regulated-overlay",enabled:config.industryOverlay==="regulated",run:opts=>generateRegulated(config,opts).files},{key:"compliance-menu",enabled:!0,run:opts=>generateComplianceMenu(config,opts).files},{key:"solo-exception",enabled:config.collaborationMode==="trunk-solo"&&levelAtLeast(config.governanceLevel,"L3"),run:opts=>generateSoloException(config,opts).files}]}function buildAnalysisSpecs(config){return[...buildBoundarySpecs(config),{key:"audit-toolchain",enabled:config.enableAuditToolchain===!0,run:opts=>generateAuditToolchain(config,opts).files},{key:"mutation",enabled:config.enableMutationTesting!==!1,run:opts=>generateMutation(config,opts).files},{key:"ci-tier",enabled:(config.permitGitHub??config.useGitHub)&&!config.enableFiveLaneCi,run:opts=>generateCiTier(config,opts).files},{key:"ci-five-lane",enabled:(config.permitGitHub??config.useGitHub)&&config.enableFiveLaneCi===!0,run:opts=>generateCiFiveLane(config,opts).files},{key:"local-wrapper",enabled:!0,run:opts=>generateLocalWrapper(config,opts).files},{key:"env-template",enabled:!0,run:opts=>generateEnvTemplate(config,opts).files},{key:"integration-testing",enabled:config.hasDatabase,run:opts=>generateIntegrationTesting(config,opts).files},{key:"contract-testing",enabled:config.enableContractTesting!==!1,run:opts=>generateContractTesting(config,opts).files},{key:"evidence-retention",enabled:config.enableEvidenceHarness!==!1,run:opts=>generateEvidenceRetention(config,opts).files},{key:"test-taxonomy",enabled:!0,run:opts=>generateTestTaxonomy(config,opts).files},{key:"operations",enabled:config.enableOperationsHandbook===!0,run:opts=>generateOperations(config,opts).files},...buildGovernanceOverlaySpecs(config),{key:"behavioral-tests",enabled:!0,run:opts=>generateBehavioralTests(config,opts).files},{key:"playwright-python",enabled:config.language==="python"&&(config.archetype==="frontend-spa"||config.archetype===BACKEND_WEB_DB),run:opts=>generatePlaywrightPython(config,opts).files},{key:"playwright-ts",enabled:(config.language==="typescript"||config.language==="multi")&&(config.archetype==="frontend-spa"||config.archetype===BACKEND_WEB_DB),run:opts=>generatePlaywrightTs(config,opts).files},{key:"e2e-constitution",enabled:config.archetype==="frontend-spa"||config.archetype===BACKEND_WEB_DB,run:opts=>generateE2eConstitution(config,opts).files},{key:"ssot",enabled:!0,run:opts=>generateSsot(config,opts).files},{key:"frontend-governance",enabled:config.archetype==="frontend-spa"||config.lanes.includes("frontend"),run:opts=>generateFrontendGovernance(config,opts).files},{key:"frontend-quality",enabled:config.archetype==="frontend-spa"||config.lanes.includes("frontend"),run:opts=>generateFrontendQuality(config,opts).files}]}function buildPerfSpecs(config){return[{key:"perf-k6",enabled:config.enablePerfTesting===!0,run:opts=>generatePerfK6(config,opts).files}]}function buildProviderSpecs(config){return[{key:"observability",enabled:config.observability!=null&&config.observability.provider!=="none",run:opts=>generateObservability(config,opts).files},{key:"auth",enabled:config.auth!=null&&config.auth.provider!=="none",run:opts=>generateAuth(config,opts).files}]}export function buildRegistry(config,installedSkills=[]){return[...buildAiToolSpecs(config,installedSkills),...buildInfraSpecs(config),...buildBackendServiceSpecs(config),...buildAnalysisSpecs(config),...buildPerfSpecs(config),...buildProviderSpecs(config),{key:"anti-drift-validators",enabled:!0,run:opts=>generateAntiDriftValidators(config,opts).files},{key:"feature-matrix",enabled:config.governanceLevel!=="L1",run:opts=>generateFeatureMatrix(config,opts).files},{key:"gap",enabled:config.governanceLevel!=="L1",run:opts=>generateGap(config,opts).files},{key:"wiki",enabled:config.governanceLevel!=="L1",run:opts=>generateWiki(config,opts).files},{key:"pr-tooling",enabled:!0,run:opts=>generatePrTooling(config,opts).files},{key:"conformance",enabled:!0,run:opts=>generateConformanceScript(config,opts).files},{key:"gold-kit",enabled:!0,run:opts=>generateGoldKit(config,opts).files},{key:"doc-set-skeletons",enabled:!0,run:opts=>generateDocSetSkeletons(config,opts).files}]}function safeRun(spec,opts,errors){try{return spec.run(opts)}catch(err){const message=err instanceof Error?err.message:String(err);return getLogger().warn("registry.generator_failed",{generator:spec.key,err:message},`generator '${spec.key}' failed: ${message}`),errors.push({key:spec.key,message}),[]}}export function runGeneratorsFromRegistry(specs,errors=[],opts){return specs.filter(s=>s.enabled).flatMap(s=>safeRun(s,opts,errors))}export function runGeneratorsSelective(specs,keys,errors=[],opts){return keys.has("*")?runGeneratorsFromRegistry(specs,errors,opts):specs.filter(s=>s.enabled&&keys.has(s.key)).flatMap(s=>safeRun(s,opts,errors))}

package/dist/generators/regulated.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 generateRegulated(config,opts={dryRun:!1}){if(config.industryOverlay!=="regulated")return{files:[]};const base=config.targetDir,data=config,userData={skipIfExists:!0,dryRun:opts.dryRun},managed={skipIfExists:!1,dryRun:opts.dryRun};return{files:[writeFile(resolvedPath(base,".arbiter/regulated","overlay.json"),renderTemplate("regulated/overlay.json.ejs",data),userData),writeFile(resolvedPath(base,"scripts","check-regulated-overlay.mjs"),renderTemplate("scripts/check-regulated-overlay.mjs.ejs",data),managed),writeFile(resolvedPath(base,"docs/compliance","regulated-overlay.md"),renderTemplate("regulated/regulated-overlay.md.ejs",data),userData)]}}

package/dist/generators/resilience.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 generateResilience(config,opts={dryRun:!1}){return config.archetype!=="backend-web-db"||config.governanceLevel==="L1"?{files:[]}:{files:[writeFile(resolvedPath(config.targetDir,"docs","GOVERNANCE","RESILIENCE.md"),renderTemplate("resilience/RESILIENCE.md.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/risk-register.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 generateRiskRegister(config,opts={dryRun:!1}){const base=config.targetDir;return{files:[writeFile(resolvedPath(base,"docs","GOVERNANCE","RISK_REGISTER.md"),renderTemplate("governance/risk-register.md.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"docs","GOVERNANCE","RISK_ASSESSMENT_TEMPLATE.md"),renderTemplate("governance/risk-assessment-template.md.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/root.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";export function generateRoot(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data={...config,nodeVersion:"22.21.1",strictnessTier:config.strictnessTier??"practical"};config.githubOwner&&(config.permitGitHub??config.useGitHub)&&results.push(writeFile(resolvedPath(base,".github","CODEOWNERS"),renderTemplate("root/CODEOWNERS.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"SECURITY.md"),renderTemplate("root/SECURITY.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"CONTRIBUTING.md"),renderTemplate("root/CONTRIBUTING.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,".editorconfig"),renderTemplate("root/editorconfig.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,".nvmrc"),renderTemplate(".nvmrc.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.language==="rust"&&data.strictnessTier==="pedantic"&&config.architectureStyle!=="hexagonal"&&results.push(writeFile(resolvedPath(base,"clippy.toml"),renderTemplate("rust/clippy.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const commitlintPath=resolvedPath(base,"commitlint.config.js");return results.push(writeFile(commitlintPath,formatContent(renderTemplate("root/commitlint.config.js.ejs",data),commitlintPath,base),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/rust-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 generateRustBoundaries(config,opts={dryRun:!1}){if(config.language!=="rust")return{files:[]};if(config.architectureStyle!=="hexagonal")return{files:[]};const base=config.targetDir,data={...config,strictnessTier:config.strictnessTier??"practical"};return{files:[writeFile(resolvedPath(base,"deny.toml"),renderTemplate("boundaries/deny.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"clippy.toml"),renderTemplate("boundaries/clippy.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts/check-boundaries.mjs"),renderTemplate("boundaries/check-boundaries-rust.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/safety-class.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+const SAFETY_CLASS_PATTERN=/^\.claude\/hooks\/[^/]+\.mjs$/,GATE_SPINE_PATTERN=/^scripts\/(?:check-all\.mjs|lib\/[^/]+\.mjs)$/;export const GOVERNANCE_CLASS_KEYS=new Set(["AGENTS.md",".claude/settings.json"]);export function isSafetyClassKey(key){return SAFETY_CLASS_PATTERN.test(key)}export function isGateSpineKey(key){return GATE_SPINE_PATTERN.test(key)}export function isGovernanceClassKey(key){return GOVERNANCE_CLASS_KEYS.has(key)}

package/dist/generators/security.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";function renderSecurityTemplate(templatePath,data){try{return renderTemplate(templatePath,data)}catch(err){throw new Error(`security.ts: template not found or failed to render at ${templatePath} \u2014 check installation`,{cause:err})}}export function generateSecurity(config,opts={dryRun:!1}){const base=config.targetDir,data=config,results=[];return results.push(writeFile(resolvedPath(base,"scripts","pii-scan.mjs"),renderSecurityTemplate("scripts/pii-scan.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun})),config.enableSecurityScanning?(results.push(writeFile(resolvedPath(base,".gitleaks.toml"),renderSecurityTemplate("security/gitleaks.toml.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.existing.aiRulez||results.push(writeFile(resolvedPath(base,".claude","hooks","check-no-pii.mjs"),renderSecurityTemplate("claude/hooks/check-no-pii.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.archetype==="backend-web-db"&&(results.push(writeFile(resolvedPath(base,".zap","rules.tsv"),renderSecurityTemplate("security/zap/rules.tsv.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,".zap","baseline-auth.context"),renderSecurityTemplate("security/zap/baseline-auth.context.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"scripts","ingest-zap-report.mjs"),renderSecurityTemplate("scripts/ingest-zap-report.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun}))),{files:results}):{files:results}}

package/dist/generators/seed.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 generateSeed(config,opts={dryRun:!1}){if(config.archetype!=="backend-web-db"||config.governanceLevel==="L1")return{files:[]};const base=config.targetDir,data=config,seedScriptPath=resolvedPath(base,"scripts","seed-test-data.sh"),commonLibPath=resolvedPath(base,"scripts","lib","seed-common.sh"),seedResult=writeFile(seedScriptPath,renderTemplate("scripts/seed-test-data.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});!opts.dryRun&&seedResult.action!=="skipped"&&chmodTranslated(seedScriptPath,SCRIPT_MODE);const commonResult=writeFile(commonLibPath,renderTemplate("scripts/lib/seed-common.sh.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun});return{files:[seedResult,commonResult]}}

package/dist/generators/self-validation.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 generateSelfValidation(config,opts={dryRun:!1}){const results=[],base=config.targetDir,scriptPath=resolvedPath(base,"scripts","self-validation.mjs");results.push(writeFile(scriptPath,renderTemplate("scripts/self-validation.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}));const exitContractPath=resolvedPath(base,"scripts","check-exit-code-contract.mjs");results.push(writeFile(exitContractPath,renderTemplate("scripts/check-exit-code-contract.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun}));const pipeTeeHazardPath=resolvedPath(base,"scripts","check-pipe-tee-hazard.mjs");return results.push(writeFile(pipeTeeHazardPath,renderTemplate("scripts/check-pipe-tee-hazard.mjs.ejs",config),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/ship-driver.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,LABEL_RE=/^[A-Za-z0-9._-]+$/,HARNESS_RE=/^[A-Za-z0-9._/-]+$/;export function generateShipDriver(config,opts={}){const shipLabel=opts.shipLabel??"ship",harnessCmd=opts.harnessCmd??"claude",dryRun=opts.dryRun??!1;if(!LABEL_RE.test(shipLabel))throw new Error(`ship-driver: invalid shipLabel "${shipLabel}" \u2014 allowed: [A-Za-z0-9._-]`);if(!HARNESS_RE.test(harnessCmd))throw new Error(`ship-driver: invalid harnessCmd "${harnessCmd}" \u2014 allowed: [A-Za-z0-9._/-]`);const data={...config,shipLabel,harnessCmd},base=config.targetDir,files=[],supervisorPath=resolvedPath(base,".arbiter","ship","supervisor.sh"),supervisor=writeFile(supervisorPath,renderTemplate("ship/supervisor.sh.ejs",data),{skipIfExists:!0,dryRun});return!dryRun&&supervisor.action!=="skipped"&&chmodTranslated(supervisorPath,SCRIPT_MODE),files.push(supervisor),files.push(writeFile(resolvedPath(base,".arbiter","ship","TICK_PROMPT.md"),renderTemplate("ship/TICK_PROMPT.md.ejs",data),{skipIfExists:!0,dryRun})),{files}}

package/dist/generators/skill-names.json

@@ -0,0 +1,17 @@
+[
+  "tdd",
+  "verification",
+  "architect-review",
+  "clean-code",
+  "understand-code",
+  "codebase-audit",
+  "epic-decompose",
+  "configure",
+  "brainstorming",
+  "wave-drain",
+  "impact",
+  "gold-audit",
+  "close-gold-gap",
+  "levelup",
+  "tabletop"
+]

package/dist/generators/skills.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{getSkillsMatrixEntries}from"../compatibility/skills-validator.js";import skillNames from"./skill-names.json"with{type:"json"};export const SKILL_NAMES=skillNames;const PROJECT_SKILL_OWNER="project",SKILL_NAME_SET=new Set(SKILL_NAMES);export function excludeOwnEmittedSkills(skills){return skills.filter(s=>{if(s.pluginOwner!==PROJECT_SKILL_OWNER)return!0;const name=s.skillId.slice(s.skillId.indexOf(":")+1);return!SKILL_NAME_SET.has(name)})}function parseSemver(v){const m=/^(\d+)\.(\d+)\.(\d+)/.exec(v.trim());return m?[Number(m[1]),Number(m[2]),Number(m[3])]:null}function compareSemver(a,b){for(let i=0;i<3;i++){const d=(a[i]??0)-(b[i]??0);if(d!==0)return d>0?1:-1}return 0}function satisfiesRange(version,range){const m=/^\s*(>=|<=|>|<|=)?\s*(\d+\.\d+\.\d+.*)$/.exec(range.trim());if(!m)return!1;const target=parseSemver(m[2]??""),have=parseSemver(version);if(!target||!have)return!1;const cmp=compareSemver(have,target);switch(m[1]??"="){case">=":return cmp>=0;case">":return cmp>0;case"<=":return cmp<=0;case"<":return cmp<0;default:return cmp===0}}function findReplacingSkill(skillName,installedSkills){const matrixEntries=getSkillsMatrixEntries();for(const installed of installedSkills){const entry=matrixEntries.find(e=>e.skillId===installed.skillId);if(entry?.replaces.includes(skillName)&&installed.version!=="unknown"&&satisfiesRange(installed.version,entry.versionRange))return installed}}export function computeSkipReport(installedSkills){if(installedSkills.length===0)return[];const skipped=[];for(const name of SKILL_NAMES){const replacing=findReplacingSkill(name,installedSkills);replacing&&skipped.push({generator:name,reason:`Replaced by installed skill "${replacing.skillId}" \u2014 no built-in SKILL.md generated`,replacedBy:replacing.skillId})}return skipped}export function generateSkills(config,installedSkills=[],opts={dryRun:!1}){if(!config.tools.includes("claude"))return{files:[],skipped:[]};const base=config.targetDir,files=[],skipped=[];for(const name of SKILL_NAMES){const replacing=findReplacingSkill(name,installedSkills);if(replacing){skipped.push({generator:name,reason:`Replaced by installed skill "${replacing.skillId}" \u2014 no built-in SKILL.md generated`,replacedBy:replacing.skillId});continue}files.push(writeFile(resolvedPath(base,".claude","skills",name,"SKILL.md"),renderTemplate(`claude/skills/${name}/SKILL.md.ejs`,config),{skipIfExists:!0,dryRun:opts.dryRun}))}return{files,skipped}}

package/dist/generators/smoke-journeys.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{writeFile,resolvedPath}from"../utils/fs.js";import{renderTemplate}from"../utils/render.js";import{formatContent}from"../utils/prettier-format.js";const SMOKE_GLOBS=["tests/smoke/**/*.spec.ts","**/*.smoke-journey.spec.ts"],AUTHZ_RATIONALE="frontend-spa enforces authorization server-side; the authz smoke floor belongs to the backend archetype's own live-API manifest (INV-126), not the browser journey suite.";function isApplicable(archetype,language){return archetype==="frontend-spa"&&language==="typescript"}function applicabilityReason(archetype,language){return archetype==="frontend-spa"?`Smoke-journey starters are scaffolded for TypeScript frontends only (like the render-smoke floor, INV-127); add a Playwright smoke-journey suite for ${language} and flip applicable:true. Floor pending for this stack.`:archetype==="backend-web-db"?"Browser smoke-journey floor not scaffolded for a backend service archetype; the separate api-e2e gate (INV-126, api-e2e.json) mandates a live-API suite here but checks suite presence, not the login/CRUD/authz journeys specifically. Floor pending for this archetype.":`Archetype "${archetype}" has no interactive login/CRUD/authz user journeys to smoke-test.`}function buildManifest(archetype,language){return isApplicable(archetype,language)?{archetype,applicable:!0,journeys:[{id:"auth",name:"Authentication flow",globs:SMOKE_GLOBS,status:"required"},{id:"crud",name:"Core CRUD operation",globs:SMOKE_GLOBS,status:"required"},{id:"authz",name:"Authorization enforcement",globs:SMOKE_GLOBS,status:"n/a",rationale:AUTHZ_RATIONALE}]}:{archetype,applicable:!1,reason:applicabilityReason(archetype,language)}}export function generateSmokeJourneys(config,opts={dryRun:!1}){const base=config.targetDir,applicable=isApplicable(config.archetype,config.language),files=[],manifest=buildManifest(config.archetype,config.language),manifestPath=resolvedPath(base,"smoke-journeys.json");if(files.push(writeFile(manifestPath,formatContent(renderTemplate("smoke-journeys/manifest.json.ejs",{manifestJson:JSON.stringify(manifest,null,2)}),manifestPath,base),{skipIfExists:!0,dryRun:opts.dryRun})),!applicable)return{files};const smokeSpecPath=resolvedPath(base,"tests","smoke","smoke-journeys.spec.ts");return files.push(writeFile(smokeSpecPath,formatContent(renderTemplate("e2e/smoke-journeys/journeys.spec.ts.ejs",config),smokeSpecPath,base),{skipIfExists:!0,dryRun:opts.dryRun})),{files}}

package/dist/generators/solo-exception.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 generateSoloException(config,opts={dryRun:!1}){if(config.collaborationMode!=="trunk-solo")return{files:[]};if(config.governanceLevel!=="L3"&&config.governanceLevel!=="L4")return{files:[]};const base=config.targetDir,data=config,skip={skipIfExists:!0,dryRun:opts.dryRun},overwrite={skipIfExists:!1,dryRun:opts.dryRun},govDir=resolvedPath(base,"docs","governance"),scriptsDir=resolvedPath(base,"scripts");return{files:[writeFile(resolvedPath(govDir,"SOLO_DEV_EXCEPTION.md"),renderTemplate("governance/solo-dev-exception.md.ejs",data),skip),writeFile(resolvedPath(govDir,"VALIDATION_EVIDENCE_TEMPLATE.md"),renderTemplate("governance/validation-evidence.md.ejs",data),skip),writeFile(resolvedPath(govDir,"CI_MENTAL_MODEL.md"),renderTemplate("governance/ci-mental-model.md.ejs",data),skip),writeFile(resolvedPath(scriptsDir,"check-solo-reactivation.mjs"),renderTemplate("scripts/check-solo-reactivation.mjs.ejs",data),overwrite)]}}

package/dist/generators/ssot.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 generateSsot(config,opts={dryRun:!1}){const results=[],base=config.targetDir,data=config;results.push(writeFile(resolvedPath(base,"docs","METHOD","SSOT_CORE_SET.md"),renderTemplate("root/docs/METHOD/SSOT_CORE_SET.md.ejs",data),{backup:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","METHOD","KNOWLEDGE_MAP.md"),renderTemplate("root/docs/METHOD/KNOWLEDGE_MAP.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.governanceLevel!=="L1"&&(results.push(writeFile(resolvedPath(base,"docs","METHOD","ENGINEERING_DEFAULTS.md"),renderTemplate("root/docs/METHOD/ENGINEERING_DEFAULTS.md.ejs",data),{backup:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","METHOD","REUSE_REGISTRY_SPEC.md"),renderTemplate("root/docs/METHOD/REUSE_REGISTRY_SPEC.md.ejs",data),{backup:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","METHOD","PATTERNS_CATALOG.md"),renderTemplate("root/docs/METHOD/PATTERNS_CATALOG.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","METHOD","REUSE_REGISTRY.md"),renderTemplate("root/docs/METHOD/REUSE_REGISTRY.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}))),config.governanceLevel==="L4"&&results.push(writeFile(resolvedPath(base,"docs","METHOD","TRACK_ROUTER.md"),renderTemplate("root/docs/METHOD/TRACK_ROUTER.md.ejs",data),{backup:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"docs","METHOD","CANONICAL_PATHS.md"),renderTemplate("root/docs/METHOD/CANONICAL_PATHS.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}));const ssotScripts=["check-ssot-core","check-doc-links","check-knowledge-map","check-canonical-paths","knowledge-map-update"];for(const name of ssotScripts)results.push(writeFile(resolvedPath(base,"scripts",`${name}.mjs`),renderTemplate(`scripts/${name}.mjs.ejs`,data),{skipIfExists:!0,dryRun:opts.dryRun}));return{files:results}}

package/dist/generators/stride-enforcement.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 generateStrideEnforcement(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};const base=config.targetDir,data=config,results=[writeFile(resolvedPath(base,"docs","SECURITY","STRIDE.md"),renderTemplate("security/STRIDE.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"docs","GOVERNANCE","RACI.md"),renderTemplate("governance/RACI.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","check-stride-traceability.mjs"),renderTemplate("scripts/check-stride-traceability.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun})];return config.governanceLevel==="L4"&&results.push(writeFile(resolvedPath(base,"docs","SECURITY","RISK_ASSESSMENT.md"),renderTemplate("security/RISK_ASSESSMENT.md.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/suppressions.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{renderTemplate,resolveServiceBucket}from"../utils/render.js";import{writeFile,resolvedPath}from"../utils/fs.js";export function generateSuppressions(config,opts={dryRun:!1}){const base=config.targetDir,data=config,results=[writeFile(resolvedPath(base,"scripts","check-inline-suppressions.mjs"),renderTemplate("scripts/check-inline-suppressions.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun})];if(!config.enableSuppressions)return{files:results};results.push(writeFile(resolvedPath(base,"suppressions",".gitleaksignore"),renderTemplate("suppressions/gitleaksignore.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"suppressions","pii-allowlist.json"),renderTemplate("suppressions/pii-allowlist.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun}),...config.language==="java"?[writeFile(resolvedPath(base,"suppressions","archunit-baseline.json"),renderTemplate("suppressions/archunit-baseline.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})]:[],writeFile(resolvedPath(base,"suppressions","suppressions-schema.json"),renderTemplate("suppressions/suppressions-schema.json.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun}),writeFile(resolvedPath(base,"scripts","check-suppressions.mjs"),renderTemplate("scripts/check-suppressions.mjs.ejs",data),{skipIfExists:!1,dryRun:opts.dryRun}));const isJvm=config.language==="java"||config.language==="kotlin"||config.language==="multi",isService=resolveServiceBucket(config.archetype)==="service";return(isJvm||isService)&&results.push(writeFile(resolvedPath(base,".trivyignore"),renderTemplate("suppressions/trivyignore.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),config.archetype==="library"&&config.language==="typescript"&&config.governanceLevel!=="L1"&&results.push(writeFile(resolvedPath(base,"suppressions","consumer-audit-allowlist.json"),renderTemplate("suppressions/consumer-audit-allowlist.json.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/generators/test-pyramid-manifest.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{writeFile,resolvedPath}from"../utils/fs.js";import{getTestPyramidProfile}from"../config/test-pyramid-profiles.js";const L1_GLOBS={typescript:["src/**/*.test.ts","src/**/*.spec.ts","__tests__/**/*.test.ts","__tests__/**/*.spec.ts"],java:["src/test/**/*Test.java","src/test/**/*Tests.java"],kotlin:["src/test/**/*Test.kt","src/test/**/*Spec.kt"],python:["tests/**/*.py","test/**/*.py"],go:["**/*_test.go"],rust:[]},L2_GLOBS={typescript:["__tests__/property/**/*.property.test.ts","__tests__/**/*.spec.ts"],java:["src/test/**/*IT.java","src/integrationTest/**/*.java"],kotlin:["src/integrationTest/**/*IT.kt"],python:["tests/integration/**/*.py"],go:["tests/**/*_test.go","integration/**/*_test.go"],rust:["tests/**/*.rs"]},L3_GLOBS={typescript:["__tests__/contract/**/*.test.ts"],java:["src/test/**/*Contract*.java"],kotlin:["src/test/**/*Contract*.kt"],python:["tests/contract/**/*.py"],go:["contract/**/*_test.go"],rust:["tests/contract/**/*.rs"]},L4_GLOBS={typescript:["e2e/**/*.spec.ts","playwright/**/*.spec.ts","__tests__/e2e/**/*.test.ts"],java:["src/e2e/**/*.java"],kotlin:["src/e2e/**/*.kt"],python:["tests/e2e/**/*.py"],go:["e2e/**/*_test.go"],rust:["tests/e2e/**/*.rs"]},L5_GLOBS={typescript:["perf/**/*.test.ts","__tests__/perf/**/*.test.ts"],java:["src/test/**/*Performance*.java","src/test/**/*Load*.java"],kotlin:["src/test/**/*Performance*.kt"],python:["tests/perf/**/*.py"],go:["perf/**/*_test.go"],rust:["tests/perf/**/*.rs"]},GLOB_BY_LEVEL={L1:L1_GLOBS,L2:L2_GLOBS,L3:L3_GLOBS,L4:L4_GLOBS,L5:L5_GLOBS},RUST_L1_RATIONALE="Rust unit tests are inline #[test] annotations inside source files; file presence cannot confirm test existence.",GREENFIELD_TIER_RATIONALE='Greenfield scaffold: arbiter init does not fabricate tests for this tier \u2014 add real tests for it, then set status to "required" so the gate enforces it.',SCAFFOLDED_LEVEL={rust:"L2"},DEFAULT_SCAFFOLDED_LEVEL="L1";function globsForLevel(id,language){const map=GLOB_BY_LEVEL[id]??{};return language==="multi"?[...new Set(Object.values(map).flat())]:map[language]??[]}function buildManifestLevel(id,name,language){if(id==="L1"&&language==="rust")return{id,name,status:"n/a",rationale:RUST_L1_RATIONALE};const globs=globsForLevel(id,language);return id!==(SCAFFOLDED_LEVEL[language]??DEFAULT_SCAFFOLDED_LEVEL)?{id,name,globs,status:"n/a",rationale:GREENFIELD_TIER_RATIONALE}:{id,name,globs,status:"required"}}export function generateTestPyramidManifest(config,opts={dryRun:!1}){const profile=getTestPyramidProfile(config.archetype),language=config.language,levels=profile.levels.map(level=>buildManifestLevel(level.id,level.name,language)),manifest={archetype:config.archetype,levels},path=resolvedPath(config.targetDir,"test-pyramid.json"),content=JSON.stringify(manifest,null,2)+`
+`;return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/test-taxonomy.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{getTestPyramidProfile}from"../config/test-pyramid-profiles.js";function extractDomainDims(config){const taxonomy=config.taxonomy;if(taxonomy==null||typeof taxonomy!="object")return[];const dims=taxonomy.domainDims;return Array.isArray(dims)?dims.filter(d=>typeof d=="string"):[]}export function generateTestTaxonomy(config,opts={dryRun:!1}){const profile=getTestPyramidProfile(config.archetype),domainDims=extractDomainDims(config),path=resolvedPath(config.targetDir,"docs","TEST_TAXONOMY.md"),templateName=config.enableTaxonomy25d?"testing/test-taxonomy.md.ejs":"root/TEST_TAXONOMY.md.ejs",content=renderTemplate(templateName,{...config,levels:profile.levels,hasContainerIntegration:profile.hasContainerIntegration,hasPropertyTests:profile.hasPropertyTests,hasE2ETests:profile.hasE2ETests,domainDims});return{files:[writeFile(path,content,{skipIfExists:!0,dryRun:opts.dryRun})]}}

package/dist/generators/wiki.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 generateWiki(config,opts={dryRun:!1}){if(config.governanceLevel==="L1")return{files:[]};const results=[],base=config.targetDir,data=config;return results.push(writeFile(resolvedPath(base,"scripts","gen-wiki.mjs"),renderTemplate("scripts/gen-wiki.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),results.push(writeFile(resolvedPath(base,"scripts","check-wiki-lint.mjs"),renderTemplate("scripts/check-wiki-lint.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),!config.existing.aiRulez&&config.tools.includes("claude")&&results.push(writeFile(resolvedPath(base,".claude","hooks","wiki-on-commit.mjs"),renderTemplate("claude/hooks/wiki-on-commit.mjs.ejs",data),{skipIfExists:!0,dryRun:opts.dryRun})),{files:results}}

package/dist/github/branch-protection.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{runCli}from"../utils/run-cli.js";import{classifyGhError}from"./classify-gh-error.js";export function applyBranchProtection(owner,repo,collaborationMode="peer-review"){const branchProtectionPayload=JSON.stringify(collaborationMode==="trunk-solo"?{required_status_checks:null,enforce_admins:!1,required_pull_request_reviews:null,restrictions:null,allow_force_pushes:!1,allow_deletions:!1,required_linear_history:!1}:{required_status_checks:{strict:!0,contexts:["CI Required"]},enforce_admins:!1,required_pull_request_reviews:{required_approving_review_count:1,dismiss_stale_reviews:!0},restrictions:null,allow_force_pushes:!1,allow_deletions:!1,required_linear_history:!1}),repoSettingsPayload=JSON.stringify({allow_merge_commit:!0,allow_squash_merge:!1,allow_rebase_merge:!1});let branchApplied=!1,branchError=null,branchErrorKind;try{runCli("gh",["api",`repos/${owner}/${repo}/branches/main/protection`,"--method","PUT","--input","-"],{input:branchProtectionPayload}),branchApplied=!0}catch(err){branchError=err instanceof Error?err.message:String(err),branchErrorKind=classifyGhError(err)}let repoApplied=!1,repoError=null;try{runCli("gh",["api",`repos/${owner}/${repo}`,"--method","PATCH","--input","-"],{input:repoSettingsPayload}),repoApplied=!0}catch(err){repoError=err instanceof Error?err.message:String(err)}return{applied:branchApplied&&repoApplied,error:branchError,...branchErrorKind!==void 0?{errorKind:branchErrorKind}:{},repoSettingsApplied:repoApplied,repoSettingsError:repoError}}

package/dist/github/classify-gh-error.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{CliError}from"../utils/run-cli.js";const FATAL_PATTERNS=["bad credentials","token has been revoked","authentication token not found","token not found","not logged in","gh auth login","http 401","401 unauthorized"];export function classifyGhError(err){if(!(err instanceof CliError))return"recoverable";if(err.notFound)return"config";if(err.timedOut)return"fatal";const text=`${err.stderr} ${err.stdout}`.toLowerCase();return FATAL_PATTERNS.some(p=>text.includes(p))?"fatal":(text.includes("must have admin")||text.includes("resource not accessible")||text.includes("not accessible by personal access token")||text.includes("already exists")||text.includes("http 404")||text.includes("404 not found"),"recoverable")}

package/dist/github/labels.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{runCli,runCliJson}from"../utils/run-cli.js";import{TASK_SIZE_LABELS}from"../generators/labels.js";import{classifyGhError}from"./classify-gh-error.js";const STANDARD_LABELS=[{name:"bug",color:"d73a4a",description:"Something isn't working"},{name:"feature",color:"a2eeef",description:"New feature or request"},{name:"task",color:"0075ca",description:"Implementation task"},{name:"docs",color:"0075ca",description:"Documentation only"},{name:"refactor",color:"e4e669",description:"Code refactoring"},{name:"test",color:"fbca04",description:"Test additions or fixes"},{name:"ci",color:"bfd4f2",description:"CI/CD changes"},{name:"deps",color:"0366d6",description:"Dependency updates"},{name:"priority/P0",color:"b60205",description:"Critical \u2014 drop everything"},{name:"priority/P1",color:"ff9f1c",description:"High \u2014 next up"},{name:"priority/P2",color:"fbca04",description:"Normal \u2014 in backlog"},...TASK_SIZE_LABELS.map(l=>({name:l.name,color:l.color,description:l.description}))];export function provisionLabels(owner,repo){const result={created:[],updated:[],skipped:[],errors:[],classifiedErrors:[]};let existingNames;try{const raw=runCliJson("gh",["label","list","-R",`${owner}/${repo}`,"--limit","1000","--json","name"]);if(!Array.isArray(raw))throw new Error(`Unexpected gh label list output format: expected array, got ${typeof raw}`);const parsed=raw.map((item,i)=>{if(typeof item!="object"||item===null||typeof item.name!="string")throw new Error(`Unexpected gh label list item at index ${i}: missing string "name" field`);return item});existingNames=new Set(parsed.map(l=>l.name.toLowerCase()))}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);result.errors.push(`list labels failed: ${msg}`),result.classifiedErrors.push({message:`list labels failed: ${msg}`,kind}),existingNames=new Set}for(const label of STANDARD_LABELS)try{existingNames.has(label.name.toLowerCase())?(runCli("gh",["label","edit",label.name,"-R",`${owner}/${repo}`,"--color",label.color,"--description",label.description]),result.updated.push(label.name)):(runCli("gh",["label","create",label.name,"-R",`${owner}/${repo}`,"--color",label.color,"--description",label.description]),result.created.push(label.name))}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);result.errors.push(`${label.name}: ${msg}`),result.classifiedErrors.push({message:`${label.name}: ${msg}`,kind})}return result}

package/dist/github/project-board.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{runCli,runCliJson}from"../utils/run-cli.js";import{classifyGhError}from"./classify-gh-error.js";function assertGhProject(value,i){if(typeof value!="object"||value===null)throw new Error(`Unexpected gh project list output: element ${i} is not an object`);const obj=value;if(typeof obj.number!="number")throw new Error(`Unexpected gh project list output: element ${i} missing numeric "number" field`);if(typeof obj.title!="string")throw new Error(`Unexpected gh project list output: element ${i} missing string "title" field`);if(typeof obj.url!="string")throw new Error(`Unexpected gh project list output: element ${i} missing string "url" field`);return value}function assertGhField(value,i){if(typeof value!="object"||value===null||typeof value.name!="string")throw new Error(`Unexpected gh project field-list output: element ${i} missing string "name" field`);return value}function findExistingBoard(owner,prefix,warnings,classifiedErrors){try{const raw=runCliJson("gh",["project","list","--owner",owner,"--format","json","--limit","100"]);if(typeof raw!="object"||raw===null||Array.isArray(raw))throw new Error('Unexpected gh project list output: expected object with "projects" key');const rawObj=raw;if(!Array.isArray(rawObj.projects))throw new Error('Unexpected gh project list output: "projects" field is not an array');const match=rawObj.projects.map((item,i)=>assertGhProject(item,i)).find(p=>p.title===prefix||p.title.startsWith(prefix+" \xB7 "));return match?{number:match.number,url:match.url}:null}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);return warnings.push(`find-existing-board: ${msg}`),classifiedErrors.push({message:`find-existing-board: ${msg}`,kind}),null}}function existingFieldNames(owner,projectNumber,warnings,classifiedErrors){try{const raw=runCliJson("gh",["project","field-list",String(projectNumber),"--owner",owner,"--format","json"]);if(typeof raw!="object"||raw===null||Array.isArray(raw))throw new Error('Unexpected gh project field-list output: expected object with "fields" key');const rawObj=raw;if(!Array.isArray(rawObj.fields))throw new Error('Unexpected gh project field-list output: "fields" field is not an array');const fields=rawObj.fields.map((item,i)=>assertGhField(item,i));return new Set(fields.map(f=>f.name))}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);return warnings.push(`existing-field-names(#${projectNumber}): ${msg}`),classifiedErrors.push({message:`existing-field-names(#${projectNumber}): ${msg}`,kind}),new Set}}function ensureField(projectNumber,owner,spec,existingNames,accum){if(!existingNames.has(spec.name))try{runCli("gh",["project","field-create",String(projectNumber),"--owner",owner,"--name",spec.name,"--data-type","SINGLE_SELECT","--single-select-options",spec.options])}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);accum.warnings.push(`${spec.name} field: ${msg}`),accum.classifiedErrors.push({message:`${spec.name} field: ${msg}`,kind})}}export function createProjectBoard(owner,repo,projectName){if(!projectName)return{created:!1,projectUrl:null,error:"projectName must not be empty",warnings:[],classifiedErrors:[]};const prefix=`${projectName} Board \xB7 ${owner}/${repo}`,utcDate=new Date().toISOString().slice(0,10),boardTitle=`${prefix} \xB7 ${utcDate}`,warnings=[],classifiedErrors=[],accum={warnings,classifiedErrors},existing=findExistingBoard(owner,prefix,warnings,classifiedErrors);if(existing){const fieldNames2=existingFieldNames(owner,existing.number,warnings,classifiedErrors);return ensureField(existing.number,owner,{name:"Priority",options:"P0,P1,P2"},fieldNames2,accum),ensureField(existing.number,owner,{name:"Size",options:"XS,S,M,L"},fieldNames2,accum),{created:!1,projectUrl:existing.url,error:null,warnings,classifiedErrors}}let projectNumber,projectUrl;try{const raw=runCliJson("gh",["project","create","--owner",owner,"--title",boardTitle,"--format","json"]);if(typeof raw!="object"||raw===null||Array.isArray(raw))throw new Error("Unexpected gh project create output: expected object");const rawObj=raw;if(typeof rawObj.number!="number"||typeof rawObj.url!="string")throw new Error('Unexpected gh project create output: missing "number" or "url" fields');projectNumber=rawObj.number,projectUrl=rawObj.url}catch(err){const msg=err instanceof Error?err.message:String(err),kind=classifyGhError(err);return classifiedErrors.push({message:msg,kind}),{created:!1,projectUrl:null,error:msg,errorKind:kind,warnings,classifiedErrors}}const fieldNames=existingFieldNames(owner,projectNumber,warnings,classifiedErrors);return ensureField(projectNumber,owner,{name:"Priority",options:"P0,P1,P2"},fieldNames,accum),ensureField(projectNumber,owner,{name:"Size",options:"XS,S,M,L"},fieldNames,accum),{created:!0,projectUrl,error:null,warnings,classifiedErrors}}

package/dist/graph/builders/adr.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync,readdirSync}from"node:fs";import{join}from"node:path";import{GraphStore}from"../store.js";import{extractInvRefs}from"./utils.js";const ADR_DIR=join("docs","ADR"),NUMBERED_FILE_RE=/^(\d{3})-.+\.md$/;function parseFrontmatter(text){const match=/^---\n([\s\S]*?)\n---/.exec(text);if(match===null)return{};const block=match[1];if(block===void 0)return{};const fm={};for(const line of block.split(`
+`)){const colon=line.indexOf(":");if(colon===-1)continue;const key=line.slice(0,colon).trim(),raw=line.slice(colon+1).trim();fm[key]=raw.replace(/^['"]|['"]$/g,"")}return fm}export function parseAdrFile(text){const fm=parseFrontmatter(text),canonicalId=fm.canonical_id;if(canonicalId===void 0||canonicalId===""||!/^\d+$/.test(canonicalId))return null;const id=`ADR:${canonicalId}`,title=fm.title??"",status=fm.status??"Unknown",invRefs=[];for(const line of text.split(`
+`))(line.includes("**Reference:**")||line.includes("Reference:"))&&invRefs.push(...extractInvRefs(line));return{id,title,status,invRefs}}export function buildAdrNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"adr-builder",adrDirectory=opts.adrDir!==void 0?opts.adrDir:join(projectRoot,ADR_DIR);if(!existsSync(adrDirectory))return store;let fileNames;try{fileNames=readdirSync(adrDirectory).filter(f=>NUMBERED_FILE_RE.test(f)).sort()}catch{return store}for(const fileName of fileNames){let text;try{text=readFileSync(join(adrDirectory,fileName),"utf-8")}catch{continue}const entry=parseAdrFile(text);if(entry===null)continue;const node={id:entry.id,kind:"ADR",attrs:{title:entry.title,status:entry.status,source}};store.upsertNode(node);for(const invId of entry.invRefs){store.hasNode(invId)||store.upsertNode({id:invId,kind:"INV",attrs:{source:"adr-stub"}});const edge={from:entry.id,to:invId,kind:"decides",attrs:{source}};store.addEdge(edge)}}return store}

package/dist/graph/builders/ast.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync}from"node:fs";import{relative}from"node:path";import{GraphStore}from"../store.js";import{walkFiles,extractInvRefs}from"./utils.js";const TS_EXT_RE=/\.(ts|tsx)$/,JAVA_EXT_RE=/\.java$/,RUST_EXT_RE=/\.rs$/,ANNOTATION_RE=/@enforces\b|@invariant\b/,JSDOC_OPEN_RE=/\/\*\*/,JSDOC_CLOSE_RE=/\*\//,SYMBOL_DECL_RE=/^export\s+(?:default\s+)?(?:async\s+)?(?:function|class|const|let|var|abstract\s+class)\s+(\w+)/,BARE_DECL_RE=/^(?:async\s+)?(?:function|class)\s+(\w+)/,DEFAULT_SKIP_DIRS=new Set(["node_modules","dist",".git","coverage","__tests__"]);export function extractAnnotations(text){const lines=text.split(`
+`),annotations=[];let inJsDoc=!1,pendingInvIds=[];for(let i=0;i<lines.length;i++){const line=lines[i];if(line!==void 0){if(!inJsDoc){JSDOC_OPEN_RE.test(line)&&(inJsDoc=!0,pendingInvIds=[],ANNOTATION_RE.test(line)&&pendingInvIds.push(...extractInvRefs(line)));continue}if(JSDOC_CLOSE_RE.test(line)){if(inJsDoc=!1,pendingInvIds.length>0){const symbolName=findNextSymbolName(lines,i+1);symbolName!==null&&annotations.push({symbolName,invIds:[...pendingInvIds]}),pendingInvIds=[]}continue}ANNOTATION_RE.test(line)&&pendingInvIds.push(...extractInvRefs(line))}}return annotations}function findNextSymbolName(lines,startIdx){for(let j=startIdx;j<Math.min(startIdx+5,lines.length);j++){const rawLine=lines[j];if(rawLine===void 0)continue;const line=rawLine.trim();if(line==="")continue;const m=SYMBOL_DECL_RE.exec(line);if(m!==null){const name=m[1];return name!==void 0?name:null}const m2=BARE_DECL_RE.exec(line);if(m2!==null){const name=m2[1];return name!==void 0?name:null}break}return null}export function buildAstNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"ast-builder",extensions=opts.extensions??["ts"],skipDirs=opts.skipDirs!==void 0?new Set(opts.skipDirs):DEFAULT_SKIP_DIRS,extSet=new Set(extensions),isTs=extSet.has("ts"),isJava=extSet.has("java"),isRust=extSet.has("rust");if(!existsSync(projectRoot))return store;const files=walkFiles(projectRoot,f=>{const segments=f.replace(/\\/g,"/").split("/");for(const seg of segments)if(skipDirs.has(seg))return!1;return!!(isTs&&TS_EXT_RE.test(f)||isJava&&JAVA_EXT_RE.test(f)||isRust&&RUST_EXT_RE.test(f))});for(const filePath of files){let text;try{text=readFileSync(filePath,"utf-8")}catch{continue}if(!ANNOTATION_RE.test(text))continue;const relPath=relative(projectRoot,filePath),annotations=extractAnnotations(text);for(const ann of annotations){const symbolId=`SYMBOL:${relPath}:${ann.symbolName}`,fileNode={id:`FILE:${relPath}`,kind:"FILE",attrs:{path:relPath,source}};store.upsertNode(fileNode),store.upsertNode({id:symbolId,kind:"SYMBOL",attrs:{name:ann.symbolName,path:relPath,source}});for(const invId of ann.invIds){store.hasNode(invId)||store.upsertNode({id:invId,kind:"INV",attrs:{source:"ast-stub"}});const edge={from:symbolId,to:invId,kind:"implements",attrs:{source}};store.addEdge(edge)}}}return store}

package/dist/graph/builders/canon.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync}from"node:fs";import{join}from"node:path";import{GraphStore}from"../store.js";const CANON_MD_PATH=join("docs","SYSTEM","CANON.md"),CANON_HEADING_RE=/^## (CANON-\d+)\s*(?:[—-]+)?\s*(.*)/,PROMOTED_TO_RE=/\*\*Promoted to:\*\*\s*(INV-\d+)/;export function parseCanon(text){const entries=[],sections=text.split(/^(?=## CANON-)/m);for(const section of sections){const headingMatch=CANON_HEADING_RE.exec(section);if(headingMatch===null)continue;const idRaw=headingMatch[1],ruleTitleRaw=headingMatch[2];if(idRaw===void 0||ruleTitleRaw===void 0)continue;const id=idRaw.trim(),ruleTitle=ruleTitleRaw.trim(),promotedMatch=PROMOTED_TO_RE.exec(section),promotedRaw=promotedMatch!==null?promotedMatch[1]:void 0,promotedTo=promotedRaw!==void 0?promotedRaw.trim():null;entries.push({id,title:ruleTitle,promotedTo})}return entries}export function buildCanonNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"canon-builder",canonFile=opts.canonPath!==void 0?opts.canonPath:join(projectRoot,CANON_MD_PATH);if(!existsSync(canonFile))return store;let text;try{text=readFileSync(canonFile,"utf-8")}catch{return store}const entries=parseCanon(text);for(const entry of entries){const node={id:entry.id,kind:"CANON",attrs:{title:entry.title,promotedTo:entry.promotedTo??null,source}};if(store.upsertNode(node),entry.promotedTo!==null){const invId=entry.promotedTo;store.hasNode(invId)||store.upsertNode({id:invId,kind:"INV",attrs:{source:"canon-stub"}});const edge={from:entry.id,to:invId,kind:"promotes",attrs:{source}};store.addEdge(edge)}}return store}

package/dist/graph/builders/evidence.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{join}from"node:path";import{GraphStore}from"../store.js";import{loadSummaryFile}from"../../evidence/load.js";const EVIDENCE_PATHS=[join(".evidence","SUMMARY.json"),join(".arbiter","SUMMARY.json")],OBS_GATE_ID="GATE:obs-gate";export function buildEvidenceNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"evidence-builder";let summaryPath;if(opts.summaryPath!==void 0)summaryPath=opts.summaryPath;else for(const candidate of EVIDENCE_PATHS){const full=join(projectRoot,candidate);if(loadSummaryFile(full).ok){summaryPath=full;break}}if(summaryPath===void 0)return store;const loaded=loadSummaryFile(summaryPath);if(!loaded.ok)return store;const summary=loaded.body,headSha=typeof summary.head_sha=="string"?summary.head_sha:"unknown",headShaShort=typeof summary.head_sha_short=="string"?summary.head_sha_short:headSha.slice(0,8),timestamp=typeof summary.timestamp=="string"?summary.timestamp:void 0,obsGate=typeof summary.obs_gate=="string"?summary.obs_gate:"unknown",evidenceId=`EVIDENCE:${headShaShort}`,evidenceNode={id:evidenceId,kind:"EVIDENCE",attrs:{head_sha:headSha,head_sha_short:headShaShort,obs_gate:obsGate,...timestamp!==void 0?{timestamp}:{},path:summaryPath,source}};store.upsertNode(evidenceNode),store.upsertNode({id:OBS_GATE_ID,kind:"GATE",attrs:{mechanism:"obs-gate",title:"obs-gate",source}});const edge={from:OBS_GATE_ID,to:evidenceId,kind:"produces",attrs:{source}};return store.addEdge(edge),store}

package/dist/graph/builders/inv.js

@@ -0,0 +1 @@
+import{GraphStore}from"../store.js";const DEFAULT_SOURCE="inv-catalog";export function buildInvNodes(invariants,store=new GraphStore,opts={}){const source=opts.source??DEFAULT_SOURCE,active=invariants.filter(inv=>inv.status!=="retired");for(const inv of active){const invNode={id:inv.id,kind:"INV",attrs:{title:inv.title,tier:inv.tier,alwaysActive:inv.alwaysActive,...inv.minGovernanceLevel!==void 0?{minGovernanceLevel:inv.minGovernanceLevel}:{},source}};store.upsertNode(invNode);const enforcement=inv.enforcement?.trim();if(enforcement===void 0||enforcement==="")continue;const mechanisms=splitEnforcement(enforcement);for(const mechanism of mechanisms){const gateId=`GATE:${mechanism}`,gateNode={id:gateId,kind:"GATE",attrs:{mechanism,title:mechanism,source}};store.upsertNode(gateNode);const edge={from:inv.id,to:gateId,kind:"enforces",attrs:{source}};store.addEdge(edge)}}return store}export function splitEnforcement(raw){const seen=new Set,out=[];for(const part of raw.split(";")){const trimmed=part.trim();trimmed!==""&&(seen.has(trimmed)||(seen.add(trimmed),out.push(trimmed)))}return out}

package/dist/graph/builders/req.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync}from"node:fs";import{join}from"node:path";import{GraphStore}from"../store.js";const CANDIDATE_FILES=["FEATURE_MATRIX.md","REQUIREMENTS_MATRIX.md"];export function parseReqText(text,sourceFile){const entries=[],seen=new Set;for(const line of text.split(`
+`)){const tableMatch=/^\s*\|\s*(REQ-\d+)\s*\|\s*([^|]+)/.exec(line);if(tableMatch!==null){const idRaw=tableMatch[1],titleRaw=tableMatch[2];if(idRaw===void 0||titleRaw===void 0)continue;const id=idRaw.trim(),title=titleRaw.trim();seen.has(id)||(seen.add(id),entries.push({id,title,sourceFile}));continue}const headingMatch=/^#{1,3}\s+(REQ-\d+)[:\s-]+(.+)/.exec(line);if(headingMatch!==null){const idRaw=headingMatch[1],titleRaw=headingMatch[2];if(idRaw===void 0||titleRaw===void 0)continue;const id=idRaw.trim(),title=titleRaw.trim();seen.has(id)||(seen.add(id),entries.push({id,title,sourceFile}))}}return entries}export function buildReqNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"req-builder",candidateFiles=opts.files??CANDIDATE_FILES.map(f=>join(projectRoot,f));for(const filePath of candidateFiles){if(!existsSync(filePath))continue;let text;try{text=readFileSync(filePath,"utf-8")}catch{continue}const entries=parseReqText(text,filePath);for(const entry of entries){const node={id:entry.id,kind:"REQ",attrs:{title:entry.title,sourceFile:entry.sourceFile,source}};store.upsertNode(node)}}return store}

package/dist/graph/builders/test-nodes.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync}from"node:fs";import{relative}from"node:path";import{GraphStore}from"../store.js";import{walkFiles,unique}from"./utils.js";const TEST_EXT_RE=/\.(test|spec)\.(ts|tsx|js|mts)$/,TEST_TITLE_RE=/(?:it|test|describe)\s*\(\s*[`'"]/,DEFAULT_SKIP_DIRS=new Set(["node_modules","dist",".git","coverage"]);function extractTagsFromLine(line){const invRefs=[],reqRefs=[],matches=Array.from(line.matchAll(/\[(INV-\d+|REQ-\d+)\]/g),m=>m[1]);for(const tag of matches)tag!==void 0&&(tag.startsWith("INV-")?invRefs.push(tag):tag.startsWith("REQ-")&&reqRefs.push(tag));return{invRefs,reqRefs}}export function parseTestFile(text,relPath){const invRefs=[],reqRefs=[];for(const line of text.split(`
+`)){if(!TEST_TITLE_RE.test(line))continue;const tags=extractTagsFromLine(line);invRefs.push(...tags.invRefs),reqRefs.push(...tags.reqRefs)}return{id:`TEST:${relPath}`,path:relPath,invRefs:unique(invRefs),reqRefs:unique(reqRefs)}}export function buildTestNodes(store=new GraphStore,opts={},projectRoot="."){const source=opts.source??"test-builder",skipDirs=opts.skipDirs!==void 0?new Set(opts.skipDirs):DEFAULT_SKIP_DIRS,pattern=opts.pattern??TEST_EXT_RE;if(!existsSync(projectRoot))return store;const files=walkFiles(projectRoot,f=>{const segments=f.replace(/\\/g,"/").split("/");for(const seg of segments)if(skipDirs.has(seg))return!1;return pattern.test(f)});for(const filePath of files){let text;try{text=readFileSync(filePath,"utf-8")}catch{continue}const relPath=relative(projectRoot,filePath);emitTestFileNodes(store,parseTestFile(text,relPath),source)}return store}function emitTestFileNodes(store,entry,source){if(entry.invRefs.length===0&&entry.reqRefs.length===0)return;const node={id:entry.id,kind:"TEST",attrs:{path:entry.path,invRefs:entry.invRefs,reqRefs:entry.reqRefs,source}};store.upsertNode(node);for(const invId of entry.invRefs){store.hasNode(invId)||store.upsertNode({id:invId,kind:"INV",attrs:{source:"test-stub"}});const edge={from:entry.id,to:invId,kind:"proves",attrs:{source}};store.addEdge(edge)}for(const reqId of entry.reqRefs){store.hasNode(reqId)||store.upsertNode({id:reqId,kind:"REQ",attrs:{source:"test-stub"}});const edge={from:entry.id,to:reqId,kind:"proves",attrs:{source}};store.addEdge(edge)}}

package/dist/graph/builders/utils.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{readdirSync,statSync}from"node:fs";import{join}from"node:path";export function extractInvRefs(text){return unique(Array.from(text.matchAll(/\bINV-\d+\b/g),m=>m[0]))}export function unique(items){const seen=new Set,out=[];for(const item of items)seen.has(item)||(seen.add(item),out.push(item));return out}export function walkFiles(dir,predicate){const results=[];return _walk(dir,predicate,results,new Set),results.sort()}function _walk(dir,predicate,out,visited){try{const{ino,dev}=statSync(dir),key=`${dev}:${ino}`;if(visited.has(key))return;visited.add(key)}catch{return}let entries;try{entries=readdirSync(dir)}catch{return}entries.sort();for(const entry of entries){const full=join(dir,entry);let stat;try{stat=statSync(full)}catch{continue}stat.isDirectory()?_walk(full,predicate,out,visited):predicate(full)&&out.push(full)}}

package/dist/graph/load.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+import{existsSync,readFileSync}from"node:fs";import{ALL_NODE_KINDS,ALL_EDGE_KINDS}from"./model.js";function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isValidGraphNode(v){return!(!isRecord(v)||typeof v.id!="string"||v.id.length===0||typeof v.kind!="string"||!ALL_NODE_KINDS.includes(v.kind)||!isRecord(v.attrs))}function isValidGraphEdge(v){return!(!isRecord(v)||typeof v.from!="string"||v.from.length===0||typeof v.to!="string"||v.to.length===0||typeof v.kind!="string"||!ALL_EDGE_KINDS.includes(v.kind)||!isRecord(v.attrs))}function isValidGraphSnapshot(data){if(!isRecord(data)||!Array.isArray(data.nodes)||!Array.isArray(data.edges))return!1;for(const node of data.nodes)if(!isValidGraphNode(node))return!1;for(const edge of data.edges)if(!isValidGraphEdge(edge))return!1;return!0}export function loadGraphSnapshot(inPath){if(!existsSync(inPath))return{ok:!1,reason:`graph snapshot not found at ${inPath} \u2014 run \`arbiter graph build\` first`};try{const raw=readFileSync(inPath,"utf-8"),parsed=JSON.parse(raw);return isValidGraphSnapshot(parsed)?{ok:!0,snapshot:parsed}:{ok:!1,reason:"graph.json failed schema validation \u2014 expected { nodes: GraphNode[], edges: GraphEdge[] }"}}catch(err){return{ok:!1,reason:`failed to parse ${inPath}: ${err instanceof Error?err.message:String(err)}`}}}

package/dist/graph/model.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
+export const ALL_NODE_KINDS=["INV","ADR","REQ","CANON","FILE","SYMBOL","TEST","EVIDENCE","GATE"],ALL_EDGE_KINDS=["enforces","decides","demands","implements","proves","produces","supersedes","promotes"];

package/dist/graph/query.js

@@ -0,0 +1,3 @@
+const DEFAULT_MAX_NODES=1e3;export function trace(store,fromId,opts={}){const origin=store.getNode(fromId);if(origin===void 0)throw new Error(`graph trace: unknown node id "${fromId}"`);const depth=opts.depth??Number.POSITIVE_INFINITY,maxNodes=opts.maxNodes??1e3,visited=new Set([origin.id]),nodes=[origin],edges=[],edgeSeen=new Set;let frontier=[origin.id],currentDepth=0;for(;frontier.length>0&&currentDepth<depth&&nodes.length<maxNodes;){const next=[];for(const id of frontier)if(expandNeighbours({store,id,visited,edgeSeen,nodes,edges,next,maxNodes}),nodes.length>=maxNodes)break;frontier=next,currentDepth+=1}return nodes.sort((a,b)=>a.id<b.id?-1:a.id>b.id?1:0),edges.sort((a,b)=>a.from!==b.from?a.from<b.from?-1:1:a.kind!==b.kind?a.kind<b.kind?-1:1:a.to<b.to?-1:a.to>b.to?1:0),{nodes,edges}}function expandNeighbours(args){const{store,id,visited,edgeSeen,nodes,edges,next,maxNodes}=args;for(const{node,edge}of store.neighbors(id)){const key=`${edge.from} ${edge.kind} ${edge.to}`;if(edgeSeen.has(key)||(edgeSeen.add(key),edges.push(edge)),!visited.has(node.id)&&(visited.add(node.id),nodes.push(node),next.push(node.id),nodes.length>=maxNodes))return}}export function toJson(snapshot){return JSON.stringify(snapshot,null,2)}export function toDot(snapshot){const lines=["digraph G {","  rankdir=LR;","  node [shape=box];"];for(const node of snapshot.nodes){const title=typeof node.attrs.title=="string"?node.attrs.title:node.id,label=`${node.kind}: ${title}`;lines.push(`  ${quoteDot(node.id)} [label=${quoteDot(label)}];`)}for(const edge of snapshot.edges)lines.push(`  ${quoteDot(edge.from)} -> ${quoteDot(edge.to)} [label="${edge.kind}"];`);return lines.push("}"),lines.join(`
+`)}export function toMermaid(snapshot){const lines=["graph LR"];for(const node of snapshot.nodes){const safeId=mermaidId(node.id),title=typeof node.attrs.title=="string"?node.attrs.title:node.id;lines.push(`  ${safeId}["${node.kind}: ${escapeMermaidLabel(title)}"]`)}for(const edge of snapshot.edges)lines.push(`  ${mermaidId(edge.from)} -->|${edge.kind}| ${mermaidId(edge.to)}`);return lines.join(`
+`)}function quoteDot(s){return`"${s.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`}function mermaidId(id){return id.replace(/[^A-Za-z0-9_]/g,"_")}function escapeMermaidLabel(s){return s.replace(/"/g,"#quot;")}

package/dist/graph/store.js

@@ -0,0 +1 @@
+export class GraphStore{nodes=new Map;edges=new Map;addNode(node){if(this.nodes.has(node.id))throw new Error(`graph: duplicate node id "${node.id}"`);this.nodes.set(node.id,node)}upsertNode(node){this.nodes.has(node.id)||this.nodes.set(node.id,node)}addEdge(edge){if(!this.nodes.has(edge.from))throw new Error(`graph: edge from unknown node "${edge.from}"`);if(!this.nodes.has(edge.to))throw new Error(`graph: edge to unknown node "${edge.to}"`);const key=edgeKey(edge);this.edges.has(key)||this.edges.set(key,edge)}getNode(id){return this.nodes.get(id)}hasNode(id){return this.nodes.has(id)}outgoing(id,kind){const out=[];for(const edge of this.edges.values())edge.from===id&&(kind!==void 0&&edge.kind!==kind||out.push(edge));return out}incoming(id,kind){const out=[];for(const edge of this.edges.values())edge.to===id&&(kind!==void 0&&edge.kind!==kind||out.push(edge));return out}neighbors(id){const result=[];for(const edge of this.outgoing(id)){const node=this.nodes.get(edge.to);node!==void 0&&result.push({node,edge})}for(const edge of this.incoming(id)){const node=this.nodes.get(edge.from);node!==void 0&&result.push({node,edge})}return result}allNodes(){return Array.from(this.nodes.values())}allEdges(){return Array.from(this.edges.values())}nodesByKind(kind){const out=[];for(const node of this.nodes.values())node.kind===kind&&out.push(node);return out}snapshot(){const nodes=Array.from(this.nodes.values()).sort((a,b)=>compareIds(a.id,b.id)),edges=Array.from(this.edges.values()).sort((a,b)=>{const f=compareIds(a.from,b.from);if(f!==0)return f;const k=a.kind.localeCompare(b.kind);return k!==0?k:compareIds(a.to,b.to)});return{nodes,edges}}}function edgeKey(edge){return`${edge.from} ${edge.kind} ${edge.to}`}function compareIds(a,b){return a<b?-1:a>b?1:0}export function storeFromSnapshot(snapshot){const store=new GraphStore;for(const node of snapshot.nodes)store.addNode(node);for(const edge of snapshot.edges)store.addEdge(edge);return store}