@attalabs/vinaya 0.19.0 → 0.19.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/README.md +37 -1
  2. package/aeg-root/contracts/architect-planner.md +1 -1
  3. package/aeg-root/enforcement.md +3 -2
  4. package/aeg-root/milestone-model.md +75 -0
  5. package/aeg-root/roles/architect.md +4 -4
  6. package/aeg-root/skills/aeg/SKILL.md +1 -1
  7. package/aeg-root/task-model.md +45 -0
  8. package/aeg-root/tranche-model.md +16 -11
  9. package/dist/checks/bin/check-body-bare-digits.js +204 -15
  10. package/dist/checks/bin/check-branch-topology.js +116 -13
  11. package/dist/checks/bin/check-brief-shape.js +116 -13
  12. package/dist/checks/bin/check-closes-n.js +116 -13
  13. package/dist/checks/bin/check-coherence.js +207 -18
  14. package/dist/checks/bin/check-dead-branch-push.js +116 -13
  15. package/dist/checks/bin/check-dispatch-readiness.js +204 -15
  16. package/dist/checks/bin/check-doc-coverage-push.js +208 -19
  17. package/dist/checks/bin/check-doc-coverage.js +208 -19
  18. package/dist/checks/bin/check-evidence-fresh.js +116 -13
  19. package/dist/checks/bin/check-first-push-dispatch.js +204 -15
  20. package/dist/checks/bin/check-issue-assignment.js +116 -13
  21. package/dist/checks/bin/check-no-disk-state.js +116 -13
  22. package/dist/checks/bin/check-reader-resolvable-prose.js +410 -36
  23. package/dist/checks/bin/check-registry-gates.js +116 -13
  24. package/dist/checks/bin/check-retired-vocabulary.js +3595 -0
  25. package/dist/checks/bin/check-review-gate.js +204 -15
  26. package/dist/checks/bin/check-single-plan-pr.js +116 -13
  27. package/dist/checks/bin/check-test-plan.js +116 -13
  28. package/dist/index.js +2362 -1602
  29. package/package.json +1 -1
  30. package/studio-standalone/apps/vinaya-studio/web/.next/BUILD_ID +1 -1
  31. package/studio-standalone/apps/vinaya-studio/web/.next/build-manifest.json +3 -3
  32. package/studio-standalone/apps/vinaya-studio/web/.next/prerender-manifest.json +3 -3
  33. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_global-error.html +1 -1
  34. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_global-error.rsc +1 -1
  35. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +1 -1
  36. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
  37. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  38. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_not-found/page/server-reference-manifest.json +2 -2
  39. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_not-found/page.js.nft.json +1 -1
  40. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
  41. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/api/coherence/route.js.nft.json +1 -1
  42. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/page/server-reference-manifest.json +2 -2
  43. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/page.js.nft.json +1 -1
  44. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/page_client-reference-manifest.js +1 -1
  45. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/backlog/page/server-reference-manifest.json +2 -2
  46. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/backlog/page.js.nft.json +1 -1
  47. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/backlog/page_client-reference-manifest.js +1 -1
  48. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/page/server-reference-manifest.json +2 -2
  49. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/page.js.nft.json +1 -1
  50. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/page_client-reference-manifest.js +1 -1
  51. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/page/server-reference-manifest.json +2 -2
  52. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/page.js.nft.json +1 -1
  53. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/page_client-reference-manifest.js +1 -1
  54. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/page/server-reference-manifest.json +2 -2
  55. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/page.js.nft.json +1 -1
  56. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/page_client-reference-manifest.js +1 -1
  57. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/tasks/[taskId]/page/server-reference-manifest.json +2 -2
  58. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/tasks/[taskId]/page.js.nft.json +1 -1
  59. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/[name]/tranches/[slug]/tasks/[taskId]/page_client-reference-manifest.js +1 -1
  60. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/page/server-reference-manifest.json +2 -2
  61. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/page.js.nft.json +1 -1
  62. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/projects/page_client-reference-manifest.js +1 -1
  63. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/tranches/page/server-reference-manifest.json +2 -2
  64. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/tranches/page.js.nft.json +1 -1
  65. package/studio-standalone/apps/vinaya-studio/web/.next/server/app/studio/tranches/page_client-reference-manifest.js +1 -1
  66. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/[root-of-the-server]__0e95dv5._.js +1 -1
  67. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/1q96_modules_@clerk_nextjs_dist_esm_app-router_client_keyless-creator-reader_0lom2js.js +1 -1
  68. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__029-1ch._.js +1 -1
  69. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/{[root-of-the-server]__0ulzsom._.js → [root-of-the-server]__0h3web3._.js} +1 -1
  70. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__0q56ohl._.js +1 -1
  71. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__1_ojzp1._.js +1 -1
  72. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__1d_8nm4._.js +1 -1
  73. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__1zkwtx8._.js +1 -1
  74. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/[root-of-the-server]__210ehg9._.js +1 -1
  75. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/_00yjcv1._.js +1 -1
  76. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/_0rix02i._.js +1 -1
  77. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/_18-d2be._.js +1 -1
  78. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/_1fqw88f._.js +5 -5
  79. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/_1gw6vc9._.js +1 -1
  80. package/studio-standalone/apps/vinaya-studio/web/.next/server/chunks/ssr/node_modules_1vo08dj._.js +2 -2
  81. package/studio-standalone/apps/vinaya-studio/web/.next/server/middleware-build-manifest.js +3 -3
  82. package/studio-standalone/apps/vinaya-studio/web/.next/server/pages/500.html +1 -1
  83. package/studio-standalone/apps/vinaya-studio/web/.next/server/server-reference-manifest.js +1 -1
  84. package/studio-standalone/apps/vinaya-studio/web/.next/server/server-reference-manifest.json +3 -3
  85. package/studio-standalone/apps/vinaya-studio/web/.next/static/chunks/{2r36w820aqwb9.js → 1hko4y648-9sa.js} +1 -1
  86. package/studio-standalone/apps/vinaya-studio/web/.next/static/chunks/{3ocvtlhgckh81.js → 20f41k165euzy.js} +1 -1
  87. package/studio-standalone/apps/vinaya-studio/web/.next/static/chunks/{2xoclb4g7d9n7.js → 3mhcu_-shkfgs.js} +1 -1
  88. package/studio-standalone/apps/vinaya-studio/web/package.json +2 -2
  89. package/templates/noop-check.template.ts +18 -0
  90. package/templates/role.template.md +20 -0
  91. /package/studio-standalone/apps/vinaya-studio/web/.next/static/{RISz5nirLr1mUfMqzSaFS → Ye7cOzO7rtvyiBouNOFES}/_buildManifest.js +0 -0
  92. /package/studio-standalone/apps/vinaya-studio/web/.next/static/{RISz5nirLr1mUfMqzSaFS → Ye7cOzO7rtvyiBouNOFES}/_clientMiddlewareManifest.js +0 -0
  93. /package/studio-standalone/apps/vinaya-studio/web/.next/static/{RISz5nirLr1mUfMqzSaFS → Ye7cOzO7rtvyiBouNOFES}/_ssgManifest.js +0 -0
@@ -565,6 +565,12 @@ function factsFromLegacyMilestone(milestone) {
565
565
  lifecycle: milestone.state === "closed" ? "complete" : "active"
566
566
  };
567
567
  }
568
+ function resolveLegacyFacts(milestone, labelIssues) {
569
+ if (milestone.state === "closed" && labelIssues.length > 0) {
570
+ return { goal: milestone.description ?? "", lifecycle: lifecycleFromIssues(labelIssues) };
571
+ }
572
+ return factsFromLegacyMilestone(milestone);
573
+ }
568
574
  function lifecycleFromIssues(issues) {
569
575
  if (issues.length === 0)
570
576
  return "planned";
@@ -581,9 +587,9 @@ function goalFromMilestones(milestones, slug) {
581
587
  function findMilestoneForSlug(owner, repo, slug) {
582
588
  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
583
589
  const legacy = matchesLegacyMilestone(milestones, slug);
584
- if (legacy)
585
- return factsFromLegacyMilestone(legacy);
586
590
  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
591
+ if (legacy)
592
+ return resolveLegacyFacts(legacy, issues);
587
593
  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
588
594
  }
589
595
 
@@ -2770,16 +2776,18 @@ function checkDeadBranchPush(input) {
2770
2776
  }
2771
2777
  // ../../packages/aeg-core/src/reader-resolvable-prose.ts
2772
2778
  var SHIPS_PREFIX = "aeg-root/";
2773
- var SHIPS_ARCHIVE_PREFIX = "aeg-root/tranches/completed/";
2779
+ function shipsArchivePrefix(shipsPrefix) {
2780
+ return `${shipsPrefix}tranches/completed/`;
2781
+ }
2774
2782
  function isSpecFile2(path) {
2775
2783
  return path.startsWith("apps/") && path.includes("/specs/") && path.endsWith(".md");
2776
2784
  }
2777
2785
  function isClaudeMdFile(path) {
2778
2786
  return path === "CLAUDE.md" || path.endsWith("/CLAUDE.md");
2779
2787
  }
2780
- function classifyProseFile(path, readerFacingPrefix, readerFacingSuffix) {
2781
- if (path.startsWith(SHIPS_PREFIX)) {
2782
- return path.startsWith(SHIPS_ARCHIVE_PREFIX) ? "internal" : "ships";
2788
+ function classifyProseFile(path, readerFacingPrefix, readerFacingSuffix, shipsPrefix = SHIPS_PREFIX) {
2789
+ if (path.startsWith(shipsPrefix)) {
2790
+ return path.startsWith(shipsArchivePrefix(shipsPrefix)) ? "internal" : "ships";
2783
2791
  }
2784
2792
  if (path.startsWith(readerFacingPrefix) && path.endsWith(readerFacingSuffix)) {
2785
2793
  return "reader-facing";
@@ -2814,7 +2822,7 @@ function legacySlugPattern(legacySlugs) {
2814
2822
  const alternation = legacySlugs.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
2815
2823
  return new RegExp(`(^|[^a-zA-Z0-9\\n-])(${alternation})([^a-zA-Z0-9\\n-]|$)`, "g");
2816
2824
  }
2817
- function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs = []) {
2825
+ function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs = [], shipsPrefix = SHIPS_PREFIX) {
2818
2826
  const findings = [];
2819
2827
  const legacyPattern = legacySlugPattern(legacySlugs);
2820
2828
  const patterns = [
@@ -2823,7 +2831,7 @@ function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuff
2823
2831
  ...legacyPattern ? [{ pattern: legacyPattern, what: "an internal tranche slug", group: 2 }] : []
2824
2832
  ];
2825
2833
  for (const file of files) {
2826
- const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix);
2834
+ const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix, shipsPrefix);
2827
2835
  if (!cls || !SWEPT_CLASSES.has(cls))
2828
2836
  continue;
2829
2837
  const scrubbed = stripNonProse(file.path, file.content);
@@ -2869,10 +2877,10 @@ function definesOrLinksGlossary(content, term) {
2869
2877
  return true;
2870
2878
  return /docs\/glossary|glossary\.md/i.test(content);
2871
2879
  }
2872
- function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix) {
2880
+ function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, shipsPrefix = SHIPS_PREFIX) {
2873
2881
  const findings = [];
2874
2882
  for (const file of files) {
2875
- const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix);
2883
+ const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix, shipsPrefix);
2876
2884
  if (!cls || !SWEPT_CLASSES.has(cls))
2877
2885
  continue;
2878
2886
  const scrubbed = stripNonProse(file.path, file.content);
@@ -2891,10 +2899,10 @@ function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, read
2891
2899
  }
2892
2900
  return findings;
2893
2901
  }
2894
- function checkReaderResolvableProse(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, legacySlugs = []) {
2902
+ function checkReaderResolvableProse(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, legacySlugs = [], shipsPrefix = SHIPS_PREFIX) {
2895
2903
  return [
2896
- ...checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs),
2897
- ...checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix)
2904
+ ...checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs, shipsPrefix),
2905
+ ...checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, shipsPrefix)
2898
2906
  ];
2899
2907
  }
2900
2908
  function parseGlossaryTerms(glossaryContent) {
@@ -2908,6 +2916,101 @@ function parseGlossaryTerms(glossaryContent) {
2908
2916
  }
2909
2917
  return terms;
2910
2918
  }
2919
+ // ../../packages/aeg-core/src/retired-vocabulary.ts
2920
+ var RETIRED_PATTERNS = [
2921
+ String.raw`\bD-[0-9]{3}\b`,
2922
+ "D-(###|NNN|nnn|xxx)",
2923
+ "decision (entry|logged)",
2924
+ "decision-log entry",
2925
+ "decision log entry",
2926
+ "decision log(s|ged|ging)?([^a-z]|$)",
2927
+ "decision-log",
2928
+ "decision entr",
2929
+ "decisions? (are |is )?logged",
2930
+ "log entries",
2931
+ String.raw`decisions\.md`,
2932
+ "decisions-legacy",
2933
+ "CONTRADICTION",
2934
+ "assumes Tier 3",
2935
+ "Lock: ?YES",
2936
+ "Lock: ?NO",
2937
+ "lock approvals?",
2938
+ "approves locks",
2939
+ "Conforms to lock",
2940
+ "Challenges lock",
2941
+ "checkDecisionNumbersFresh",
2942
+ String.raw`roles/team-leader\.md`,
2943
+ String.raw`\(,`,
2944
+ String.raw`,\)`,
2945
+ String.raw`\(\.\)`
2946
+ ];
2947
+ var RETIRED_EXEMPT_SUBSTRINGS = [
2948
+ "docs/decisions-legacy.md",
2949
+ "apps/herald-ai/docs/",
2950
+ "apps/vada-ai/docs/",
2951
+ "aeg-root/tranches/completed/",
2952
+ "packages/aeg-core/src/docs/published-prose",
2953
+ "packages/aeg-core/src/retired-vocabulary.test.ts",
2954
+ "packages/aeg-core/src/retired-vocabulary.ts",
2955
+ "/fixtures/",
2956
+ "/node_modules/",
2957
+ "/.next/",
2958
+ "/.turbo/"
2959
+ ];
2960
+ var PATTERN_EXEMPT = {
2961
+ [String.raw`\bD-[0-9]{3}\b`]: ["./CLAUDE.md"],
2962
+ [String.raw`decisions\.md`]: [
2963
+ "docs-index.md",
2964
+ "apps/vada-ai/specs/legacy/README.md",
2965
+ "apps/vada-ai/specs/vada-product-spec.md",
2966
+ "apps/vada-ai/web/CLAUDE.md",
2967
+ "apps/vada-ai/CLAUDE.md"
2968
+ ],
2969
+ "decisions-legacy": [
2970
+ "packages/aeg-core/src/file-classify.ts",
2971
+ "packages/aeg-core/src/file-classify.test.ts",
2972
+ "packages/aeg-core/src/pr-tier.test.ts",
2973
+ "docs-index.md",
2974
+ ".claude/skills/database/SKILL.md",
2975
+ ".claude/skills/vada-architecture/SKILL.md",
2976
+ "apps/vada-ai/specs/vada-byok-principles.md",
2977
+ "apps/vada-ai/web/CLAUDE.md",
2978
+ "apps/vada-ai/CLAUDE.md"
2979
+ ],
2980
+ CONTRADICTION: ["apps/vada-ai/specs/vada-reviewers-spec.md"]
2981
+ };
2982
+ function lineNumbers(content, pattern) {
2983
+ const out = [];
2984
+ const lines = content.split(`
2985
+ `);
2986
+ for (let i = 0;i < lines.length; i++) {
2987
+ if (pattern.test(lines[i] ?? ""))
2988
+ out.push(i + 1);
2989
+ }
2990
+ return out;
2991
+ }
2992
+ function scanRetiredVocabulary(files) {
2993
+ const findings = [];
2994
+ for (const file of files) {
2995
+ if (RETIRED_EXEMPT_SUBSTRINGS.some((e) => file.path.includes(e)))
2996
+ continue;
2997
+ for (const pattern of RETIRED_PATTERNS) {
2998
+ const patternExempt = PATTERN_EXEMPT[pattern] ?? [];
2999
+ if (patternExempt.some((e) => file.path.includes(e)))
3000
+ continue;
3001
+ const re = new RegExp(pattern);
3002
+ for (const line of lineNumbers(file.content, re)) {
3003
+ findings.push({
3004
+ file: file.path,
3005
+ line,
3006
+ pattern,
3007
+ message: `claims a retired AEG mechanism is still live (matches /${pattern}/)`
3008
+ });
3009
+ }
3010
+ }
3011
+ }
3012
+ return findings;
3013
+ }
2911
3014
  // ../../packages/aeg-core/src/dispatch-gate.ts
2912
3015
  function isHandClosedByRecognizedPrincipal(dep, principalAllowlist) {
2913
3016
  return dep.issueState === "closed" && dep.stateReason === "completed" && isPrincipal(dep.closedByActor ?? null, principalAllowlist);
@@ -3170,9 +3273,15 @@ function emitCheckError(error) {
3170
3273
 
3171
3274
  // src/lib/config.ts
3172
3275
  import { execFileSync as execFileSync2 } from "node:child_process";
3276
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3173
3277
  import { homedir } from "node:os";
3174
3278
  import { dirname, join } from "node:path";
3175
3279
  import { z } from "zod";
3280
+
3281
+ // src/lib/agent-vendors.ts
3282
+ var AGENT_VENDORS = ["skills", "claude", "gemini"];
3283
+
3284
+ // src/lib/config.ts
3176
3285
  var EnvEntrySchema = z.union([
3177
3286
  z.literal(true),
3178
3287
  z.object({ optional: z.literal(true) }),
@@ -3211,6 +3320,11 @@ var CheckEntrySchema = z.object({
3211
3320
  }
3212
3321
  }
3213
3322
  });
3323
+ var RoleEntrySchema = z.object({
3324
+ contract: z.string().refine((p) => p.includes("/"), {
3325
+ message: 'must be a path (contain at least one "/"), not a bare filename'
3326
+ })
3327
+ });
3214
3328
  var BRIEF_BUILTINS = [
3215
3329
  "tier",
3216
3330
  "testPlan",
@@ -3259,7 +3373,8 @@ var ManagedManifestSchema = z.object({
3259
3373
  version: z.number().int().positive(),
3260
3374
  files: z.array(SafeRepoRelPath),
3261
3375
  blocks: z.array(ManagedBlockRecordSchema),
3262
- labels: z.array(z.string())
3376
+ labels: z.array(z.string()),
3377
+ agents: z.array(z.enum(AGENT_VENDORS)).optional()
3263
3378
  });
3264
3379
  var VinayaConfigSchema = z.object({
3265
3380
  rings: z.object({
@@ -3267,16 +3382,79 @@ var VinayaConfigSchema = z.object({
3267
3382
  ring2_asyncAudits: z.boolean()
3268
3383
  }).optional(),
3269
3384
  checks: z.record(z.string(), CheckEntrySchema).optional(),
3385
+ roles: z.record(z.string(), RoleEntrySchema).optional(),
3270
3386
  briefSchema: BriefSchemaSchema.optional(),
3271
3387
  managed: ManagedManifestSchema.optional(),
3272
3388
  principals: z.array(z.string()).min(1).optional(),
3273
3389
  releaseActor: z.string().min(1).optional(),
3274
3390
  ci: z.object({ setup: z.string().min(1) }).optional(),
3275
- blastRadius: z.object({ extraDomains: z.array(z.string()).optional() }).optional()
3391
+ blastRadius: z.object({ extraDomains: z.array(z.string()).optional() }).optional(),
3392
+ proseGates: z.object({
3393
+ doctrineRoot: z.string().min(1).optional(),
3394
+ readerFacingPrefix: z.string().min(1).optional(),
3395
+ readerFacingSuffix: z.string().min(1).optional(),
3396
+ legacySlugDir: z.string().min(1).optional()
3397
+ }).optional()
3276
3398
  });
3277
3399
  var GLOBAL_VINAYA_HOME = join(homedir(), ".vinaya");
3278
3400
  var GLOBAL_CONFIG_PATH = join(GLOBAL_VINAYA_HOME, "config.json");
3279
3401
  var LOCAL_CONFIG_FILENAME = "vinaya.config.json";
3402
+ function findLocalConfig() {
3403
+ let dir = process.cwd();
3404
+ while (true) {
3405
+ const candidate = join(dir, LOCAL_CONFIG_FILENAME);
3406
+ if (existsSync(candidate))
3407
+ return candidate;
3408
+ if (existsSync(join(dir, ".git")))
3409
+ return null;
3410
+ const parent = dirname(dir);
3411
+ if (parent === dir)
3412
+ return null;
3413
+ dir = parent;
3414
+ }
3415
+ }
3416
+ function configPath() {
3417
+ const local = findLocalConfig();
3418
+ if (local)
3419
+ return local;
3420
+ if (existsSync(GLOBAL_CONFIG_PATH))
3421
+ return GLOBAL_CONFIG_PATH;
3422
+ return null;
3423
+ }
3424
+ function globalChecksIgnoredWarning(path) {
3425
+ return `${path}: "checks" registration in the global config is ignored — checks may only be registered from a repo-local vinaya.config.json.`;
3426
+ }
3427
+ function globalPrincipalsIgnoredWarning(path) {
3428
+ return `${path}: "principals" in the global config is ignored — principals may only be declared from a repo-local vinaya.config.json.`;
3429
+ }
3430
+ function globalRolesIgnoredWarning(path) {
3431
+ return `${path}: "roles" registration in the global config is ignored — roles may only be registered from a repo-local vinaya.config.json.`;
3432
+ }
3433
+ function globalReleaseActorIgnoredWarning(path) {
3434
+ return `${path}: "releaseActor" in the global config is ignored — releaseActor may only be declared from a repo-local vinaya.config.json.`;
3435
+ }
3436
+ function stripGlobalOnlyKeys(config, path) {
3437
+ if (path !== GLOBAL_CONFIG_PATH)
3438
+ return config;
3439
+ let result = config;
3440
+ if (result.checks && Object.keys(result.checks).length > 0) {
3441
+ console.error(`⚠ ${globalChecksIgnoredWarning(path)}`);
3442
+ result = { ...result, checks: undefined };
3443
+ }
3444
+ if (result.roles && Object.keys(result.roles).length > 0) {
3445
+ console.error(`⚠ ${globalRolesIgnoredWarning(path)}`);
3446
+ result = { ...result, roles: undefined };
3447
+ }
3448
+ if (result.principals && result.principals.length > 0) {
3449
+ console.error(`⚠ ${globalPrincipalsIgnoredWarning(path)}`);
3450
+ result = { ...result, principals: undefined };
3451
+ }
3452
+ if (result.releaseActor) {
3453
+ console.error(`⚠ ${globalReleaseActorIgnoredWarning(path)}`);
3454
+ result = { ...result, releaseActor: undefined };
3455
+ }
3456
+ return result;
3457
+ }
3280
3458
  function resolvePrincipalAllowlist(config) {
3281
3459
  return config?.principals ?? PRINCIPAL_ALLOWLIST;
3282
3460
  }
@@ -3349,6 +3527,17 @@ function loadTrustAnchorConfig(fetcher = ghFetchTrustAnchorConfig) {
3349
3527
  return null;
3350
3528
  }
3351
3529
  }
3530
+ function loadConfig() {
3531
+ const path = configPath();
3532
+ if (!path)
3533
+ return null;
3534
+ try {
3535
+ const raw = JSON.parse(readFileSync(path, "utf-8"));
3536
+ return stripGlobalOnlyKeys(VinayaConfigSchema.parse(raw), path);
3537
+ } catch {
3538
+ return null;
3539
+ }
3540
+ }
3352
3541
 
3353
3542
  // src/checks/bin/check-review-gate.ts
3354
3543
  var CHECK_NAME = "review-gate";
@@ -565,6 +565,12 @@ function factsFromLegacyMilestone(milestone) {
565
565
  lifecycle: milestone.state === "closed" ? "complete" : "active"
566
566
  };
567
567
  }
568
+ function resolveLegacyFacts(milestone, labelIssues) {
569
+ if (milestone.state === "closed" && labelIssues.length > 0) {
570
+ return { goal: milestone.description ?? "", lifecycle: lifecycleFromIssues(labelIssues) };
571
+ }
572
+ return factsFromLegacyMilestone(milestone);
573
+ }
568
574
  function lifecycleFromIssues(issues) {
569
575
  if (issues.length === 0)
570
576
  return "planned";
@@ -581,9 +587,9 @@ function goalFromMilestones(milestones, slug) {
581
587
  function findMilestoneForSlug(owner, repo, slug) {
582
588
  const milestones = ghApiGet(`repos/${owner}/${repo}/milestones?state=all&per_page=100`);
583
589
  const legacy = matchesLegacyMilestone(milestones, slug);
584
- if (legacy)
585
- return factsFromLegacyMilestone(legacy);
586
590
  const issues = ghIssueListByLabel(owner, repo, trancheLabel(slug));
591
+ if (legacy)
592
+ return resolveLegacyFacts(legacy, issues);
587
593
  return { goal: goalFromMilestones(milestones, slug), lifecycle: lifecycleFromIssues(issues) };
588
594
  }
589
595
 
@@ -2770,16 +2776,18 @@ function checkDeadBranchPush(input) {
2770
2776
  }
2771
2777
  // ../../packages/aeg-core/src/reader-resolvable-prose.ts
2772
2778
  var SHIPS_PREFIX = "aeg-root/";
2773
- var SHIPS_ARCHIVE_PREFIX = "aeg-root/tranches/completed/";
2779
+ function shipsArchivePrefix(shipsPrefix) {
2780
+ return `${shipsPrefix}tranches/completed/`;
2781
+ }
2774
2782
  function isSpecFile2(path) {
2775
2783
  return path.startsWith("apps/") && path.includes("/specs/") && path.endsWith(".md");
2776
2784
  }
2777
2785
  function isClaudeMdFile(path) {
2778
2786
  return path === "CLAUDE.md" || path.endsWith("/CLAUDE.md");
2779
2787
  }
2780
- function classifyProseFile(path, readerFacingPrefix, readerFacingSuffix) {
2781
- if (path.startsWith(SHIPS_PREFIX)) {
2782
- return path.startsWith(SHIPS_ARCHIVE_PREFIX) ? "internal" : "ships";
2788
+ function classifyProseFile(path, readerFacingPrefix, readerFacingSuffix, shipsPrefix = SHIPS_PREFIX) {
2789
+ if (path.startsWith(shipsPrefix)) {
2790
+ return path.startsWith(shipsArchivePrefix(shipsPrefix)) ? "internal" : "ships";
2783
2791
  }
2784
2792
  if (path.startsWith(readerFacingPrefix) && path.endsWith(readerFacingSuffix)) {
2785
2793
  return "reader-facing";
@@ -2814,7 +2822,7 @@ function legacySlugPattern(legacySlugs) {
2814
2822
  const alternation = legacySlugs.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
2815
2823
  return new RegExp(`(^|[^a-zA-Z0-9\\n-])(${alternation})([^a-zA-Z0-9\\n-]|$)`, "g");
2816
2824
  }
2817
- function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs = []) {
2825
+ function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs = [], shipsPrefix = SHIPS_PREFIX) {
2818
2826
  const findings = [];
2819
2827
  const legacyPattern = legacySlugPattern(legacySlugs);
2820
2828
  const patterns = [
@@ -2823,7 +2831,7 @@ function checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuff
2823
2831
  ...legacyPattern ? [{ pattern: legacyPattern, what: "an internal tranche slug", group: 2 }] : []
2824
2832
  ];
2825
2833
  for (const file of files) {
2826
- const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix);
2834
+ const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix, shipsPrefix);
2827
2835
  if (!cls || !SWEPT_CLASSES.has(cls))
2828
2836
  continue;
2829
2837
  const scrubbed = stripNonProse(file.path, file.content);
@@ -2869,10 +2877,10 @@ function definesOrLinksGlossary(content, term) {
2869
2877
  return true;
2870
2878
  return /docs\/glossary|glossary\.md/i.test(content);
2871
2879
  }
2872
- function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix) {
2880
+ function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, shipsPrefix = SHIPS_PREFIX) {
2873
2881
  const findings = [];
2874
2882
  for (const file of files) {
2875
- const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix);
2883
+ const cls = classifyProseFile(file.path, readerFacingPrefix, readerFacingSuffix, shipsPrefix);
2876
2884
  if (!cls || !SWEPT_CLASSES.has(cls))
2877
2885
  continue;
2878
2886
  const scrubbed = stripNonProse(file.path, file.content);
@@ -2891,10 +2899,10 @@ function checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, read
2891
2899
  }
2892
2900
  return findings;
2893
2901
  }
2894
- function checkReaderResolvableProse(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, legacySlugs = []) {
2902
+ function checkReaderResolvableProse(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, legacySlugs = [], shipsPrefix = SHIPS_PREFIX) {
2895
2903
  return [
2896
- ...checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs),
2897
- ...checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix)
2904
+ ...checkUnresolvableReferences(files, readerFacingPrefix, readerFacingSuffix, legacySlugs, shipsPrefix),
2905
+ ...checkUndefinedVocabulary(files, glossaryTerms, readerFacingPrefix, readerFacingSuffix, shipsPrefix)
2898
2906
  ];
2899
2907
  }
2900
2908
  function parseGlossaryTerms(glossaryContent) {
@@ -2908,6 +2916,101 @@ function parseGlossaryTerms(glossaryContent) {
2908
2916
  }
2909
2917
  return terms;
2910
2918
  }
2919
+ // ../../packages/aeg-core/src/retired-vocabulary.ts
2920
+ var RETIRED_PATTERNS = [
2921
+ String.raw`\bD-[0-9]{3}\b`,
2922
+ "D-(###|NNN|nnn|xxx)",
2923
+ "decision (entry|logged)",
2924
+ "decision-log entry",
2925
+ "decision log entry",
2926
+ "decision log(s|ged|ging)?([^a-z]|$)",
2927
+ "decision-log",
2928
+ "decision entr",
2929
+ "decisions? (are |is )?logged",
2930
+ "log entries",
2931
+ String.raw`decisions\.md`,
2932
+ "decisions-legacy",
2933
+ "CONTRADICTION",
2934
+ "assumes Tier 3",
2935
+ "Lock: ?YES",
2936
+ "Lock: ?NO",
2937
+ "lock approvals?",
2938
+ "approves locks",
2939
+ "Conforms to lock",
2940
+ "Challenges lock",
2941
+ "checkDecisionNumbersFresh",
2942
+ String.raw`roles/team-leader\.md`,
2943
+ String.raw`\(,`,
2944
+ String.raw`,\)`,
2945
+ String.raw`\(\.\)`
2946
+ ];
2947
+ var RETIRED_EXEMPT_SUBSTRINGS = [
2948
+ "docs/decisions-legacy.md",
2949
+ "apps/herald-ai/docs/",
2950
+ "apps/vada-ai/docs/",
2951
+ "aeg-root/tranches/completed/",
2952
+ "packages/aeg-core/src/docs/published-prose",
2953
+ "packages/aeg-core/src/retired-vocabulary.test.ts",
2954
+ "packages/aeg-core/src/retired-vocabulary.ts",
2955
+ "/fixtures/",
2956
+ "/node_modules/",
2957
+ "/.next/",
2958
+ "/.turbo/"
2959
+ ];
2960
+ var PATTERN_EXEMPT = {
2961
+ [String.raw`\bD-[0-9]{3}\b`]: ["./CLAUDE.md"],
2962
+ [String.raw`decisions\.md`]: [
2963
+ "docs-index.md",
2964
+ "apps/vada-ai/specs/legacy/README.md",
2965
+ "apps/vada-ai/specs/vada-product-spec.md",
2966
+ "apps/vada-ai/web/CLAUDE.md",
2967
+ "apps/vada-ai/CLAUDE.md"
2968
+ ],
2969
+ "decisions-legacy": [
2970
+ "packages/aeg-core/src/file-classify.ts",
2971
+ "packages/aeg-core/src/file-classify.test.ts",
2972
+ "packages/aeg-core/src/pr-tier.test.ts",
2973
+ "docs-index.md",
2974
+ ".claude/skills/database/SKILL.md",
2975
+ ".claude/skills/vada-architecture/SKILL.md",
2976
+ "apps/vada-ai/specs/vada-byok-principles.md",
2977
+ "apps/vada-ai/web/CLAUDE.md",
2978
+ "apps/vada-ai/CLAUDE.md"
2979
+ ],
2980
+ CONTRADICTION: ["apps/vada-ai/specs/vada-reviewers-spec.md"]
2981
+ };
2982
+ function lineNumbers(content, pattern) {
2983
+ const out = [];
2984
+ const lines = content.split(`
2985
+ `);
2986
+ for (let i = 0;i < lines.length; i++) {
2987
+ if (pattern.test(lines[i] ?? ""))
2988
+ out.push(i + 1);
2989
+ }
2990
+ return out;
2991
+ }
2992
+ function scanRetiredVocabulary(files) {
2993
+ const findings = [];
2994
+ for (const file of files) {
2995
+ if (RETIRED_EXEMPT_SUBSTRINGS.some((e) => file.path.includes(e)))
2996
+ continue;
2997
+ for (const pattern of RETIRED_PATTERNS) {
2998
+ const patternExempt = PATTERN_EXEMPT[pattern] ?? [];
2999
+ if (patternExempt.some((e) => file.path.includes(e)))
3000
+ continue;
3001
+ const re = new RegExp(pattern);
3002
+ for (const line of lineNumbers(file.content, re)) {
3003
+ findings.push({
3004
+ file: file.path,
3005
+ line,
3006
+ pattern,
3007
+ message: `claims a retired AEG mechanism is still live (matches /${pattern}/)`
3008
+ });
3009
+ }
3010
+ }
3011
+ }
3012
+ return findings;
3013
+ }
2911
3014
  // ../../packages/aeg-core/src/dispatch-gate.ts
2912
3015
  function isHandClosedByRecognizedPrincipal(dep, principalAllowlist) {
2913
3016
  return dep.issueState === "closed" && dep.stateReason === "completed" && isPrincipal(dep.closedByActor ?? null, principalAllowlist);