safeword 0.45.0 → 0.46.1

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 (85) hide show
  1. package/dist/{check-C3IEG3XA.js → check-OP4A4UNY.js} +50 -44
  2. package/dist/check-OP4A4UNY.js.map +1 -0
  3. package/dist/chunk-3BMVTFFM.js +65 -0
  4. package/dist/chunk-3BMVTFFM.js.map +1 -0
  5. package/dist/{chunk-QARISSCT.js → chunk-445LAX4Y.js} +47 -2
  6. package/dist/chunk-445LAX4Y.js.map +1 -0
  7. package/dist/{chunk-ZLEHZR4V.js → chunk-6RATQAVM.js} +116 -102
  8. package/dist/chunk-6RATQAVM.js.map +1 -0
  9. package/dist/{chunk-I7ONBYQU.js → chunk-AFJEWSWF.js} +4 -6
  10. package/dist/{chunk-I7ONBYQU.js.map → chunk-AFJEWSWF.js.map} +1 -1
  11. package/dist/{chunk-K5EJJIPT.js → chunk-BF6AHZI7.js} +10 -6
  12. package/dist/chunk-BF6AHZI7.js.map +1 -0
  13. package/dist/{chunk-KWD4OQL4.js → chunk-GUVUMYJ3.js} +5 -7
  14. package/dist/{chunk-KWD4OQL4.js.map → chunk-GUVUMYJ3.js.map} +1 -1
  15. package/dist/cli.js +21 -14
  16. package/dist/cli.js.map +1 -1
  17. package/dist/{codify-OATQEQON.js → codify-D6WZ5AS4.js} +7 -4
  18. package/dist/codify-D6WZ5AS4.js.map +1 -0
  19. package/dist/{diff-EQIZFEKE.js → diff-RU47WQ2T.js} +6 -7
  20. package/dist/{diff-EQIZFEKE.js.map → diff-RU47WQ2T.js.map} +1 -1
  21. package/dist/{reset-XPAO6S2X.js → reset-6Y3GJ4FZ.js} +5 -6
  22. package/dist/{reset-XPAO6S2X.js.map → reset-6Y3GJ4FZ.js.map} +1 -1
  23. package/dist/{setup-TYIQKWJH.js → setup-6ES2YZFC.js} +10 -11
  24. package/dist/{setup-TYIQKWJH.js.map → setup-6ES2YZFC.js.map} +1 -1
  25. package/dist/{sync-config-X5PHVGEY.js → sync-config-JA5ASYNG.js} +3 -4
  26. package/dist/{sync-learnings-TS3UJAWI.js → sync-learnings-YNXLI7GV.js} +11 -7
  27. package/dist/sync-learnings-YNXLI7GV.js.map +1 -0
  28. package/dist/{sync-tickets-AGSPGGQN.js → sync-tickets-LG3XQX3C.js} +5 -4
  29. package/dist/sync-tickets-LG3XQX3C.js.map +1 -0
  30. package/dist/{ticket-new-DASC7THG.js → ticket-new-J3XJOQVP.js} +6 -6
  31. package/dist/ticket-new-J3XJOQVP.js.map +1 -0
  32. package/dist/upgrade-BQUEV44T.js +392 -0
  33. package/dist/upgrade-BQUEV44T.js.map +1 -0
  34. package/package.json +1 -1
  35. package/templates/SAFEWORD.md +4 -2
  36. package/templates/commands/audit.md +2 -2
  37. package/templates/commands/verify.md +4 -4
  38. package/templates/cursor/rules/safeword-ticket-system.mdc +1 -0
  39. package/templates/doc-templates/task-spec-template.md +2 -2
  40. package/templates/guides/architecture-guide.md +1 -1
  41. package/templates/guides/context-files-guide.md +1 -1
  42. package/templates/guides/learning-extraction.md +35 -35
  43. package/templates/guides/planning-guide.md +3 -3
  44. package/templates/hooks/lib/active-ticket.ts +5 -5
  45. package/templates/hooks/lib/impl-plan.ts +16 -0
  46. package/templates/hooks/lib/namespace-root.ts +74 -0
  47. package/templates/hooks/lib/quality-state.ts +4 -3
  48. package/templates/hooks/lib/replan.ts +7 -4
  49. package/templates/hooks/lib/review-ledger.ts +63 -8
  50. package/templates/hooks/lib/skill-invocation-log.ts +2 -1
  51. package/templates/hooks/post-tool-quality.ts +4 -6
  52. package/templates/hooks/post-tool-sync-learnings.ts +2 -1
  53. package/templates/hooks/pre-tool-quality.ts +8 -12
  54. package/templates/hooks/session-author-model.ts +33 -0
  55. package/templates/hooks/session-cleanup-quality.ts +2 -1
  56. package/templates/hooks/session-compact-context.ts +8 -4
  57. package/templates/hooks/session-start-reentry.ts +2 -1
  58. package/templates/hooks/stop-quality.ts +89 -8
  59. package/templates/hooks/stop-reentry.ts +3 -2
  60. package/templates/hooks/write-review-stamp.ts +18 -7
  61. package/templates/skills/audit/SKILL.md +6 -6
  62. package/templates/skills/bdd/DISCOVERY.md +9 -9
  63. package/templates/skills/bdd/SCENARIOS.md +2 -2
  64. package/templates/skills/bdd/SKILL.md +2 -2
  65. package/templates/skills/bdd/TDD.md +21 -0
  66. package/templates/skills/explain/SKILL.md +3 -3
  67. package/templates/skills/quality-review/SKILL.md +1 -1
  68. package/templates/skills/self-review/SKILL.md +1 -1
  69. package/templates/skills/ticket-system/SKILL.md +4 -2
  70. package/templates/skills/verify/SKILL.md +4 -4
  71. package/templates/spec-template.md +2 -2
  72. package/templates/statusline/reentry.ts +6 -2
  73. package/dist/check-C3IEG3XA.js.map +0 -1
  74. package/dist/chunk-46XXWC64.js +0 -39
  75. package/dist/chunk-46XXWC64.js.map +0 -1
  76. package/dist/chunk-K5EJJIPT.js.map +0 -1
  77. package/dist/chunk-QARISSCT.js.map +0 -1
  78. package/dist/chunk-ZLEHZR4V.js.map +0 -1
  79. package/dist/codify-OATQEQON.js.map +0 -1
  80. package/dist/sync-learnings-TS3UJAWI.js.map +0 -1
  81. package/dist/sync-tickets-AGSPGGQN.js.map +0 -1
  82. package/dist/ticket-new-DASC7THG.js.map +0 -1
  83. package/dist/upgrade-Q2JUR6VU.js +0 -170
  84. package/dist/upgrade-Q2JUR6VU.js.map +0 -1
  85. /package/dist/{sync-config-X5PHVGEY.js.map → sync-config-JA5ASYNG.js.map} +0 -0
@@ -3,7 +3,7 @@ import {
3
3
  findTicketsInCycles,
4
4
  readTickets,
5
5
  syncTickets
6
- } from "./chunk-K5EJJIPT.js";
6
+ } from "./chunk-BF6AHZI7.js";
7
7
  import {
8
8
  formatTicketReference
9
9
  } from "./chunk-NHXVS5FL.js";
@@ -19,30 +19,33 @@ import {
19
19
  SAFEWORD_SCHEMA,
20
20
  createProjectContext,
21
21
  getMissingPacks,
22
+ reconcile
23
+ } from "./chunk-6RATQAVM.js";
24
+ import {
25
+ defaultConfiguredPath,
22
26
  readConfiguredPath,
23
- reconcile,
24
- resolveConfiguredPath
25
- } from "./chunk-ZLEHZR4V.js";
27
+ resolveConfiguredPath,
28
+ resolveTicketsDirectory
29
+ } from "./chunk-3BMVTFFM.js";
26
30
  import "./chunk-LODQOJEK.js";
27
31
  import {
28
32
  VERSION
29
33
  } from "./chunk-HSC7TELY.js";
30
34
  import {
31
35
  exists,
32
- readFileSafe
33
- } from "./chunk-QARISSCT.js";
34
- import {
35
36
  header,
36
37
  info,
38
+ isDirectory,
37
39
  keyValue,
38
40
  listItem,
41
+ readFileSafe,
39
42
  success,
40
43
  warn
41
- } from "./chunk-46XXWC64.js";
44
+ } from "./chunk-445LAX4Y.js";
42
45
 
43
46
  // src/commands/check.ts
44
47
  import { readdirSync as readdirSync2 } from "fs";
45
- import nodePath4 from "path";
48
+ import nodePath2 from "path";
46
49
 
47
50
  // src/utils/architecture-records.ts
48
51
  import { readdirSync, statSync } from "fs";
@@ -66,7 +69,6 @@ function listArchitectureRecords(resolvedPath) {
66
69
 
67
70
  // src/utils/glossary.ts
68
71
  import { readFileSync } from "fs";
69
- import nodePath2 from "path";
70
72
 
71
73
  // src/utils/validation.ts
72
74
  function groupByLine(entries, pick) {
@@ -93,7 +95,6 @@ function findDuplicates(grouped, kind) {
93
95
  }
94
96
 
95
97
  // src/utils/glossary.ts
96
- var GLOSSARY_FILE_SUBPATH = [".safeword-project", "glossary.md"];
97
98
  function groupAliasesByLine(entries) {
98
99
  const grouped = /* @__PURE__ */ new Map();
99
100
  for (const entry of entries) {
@@ -240,7 +241,6 @@ function parseGlossary(content) {
240
241
 
241
242
  // src/utils/personas.ts
242
243
  import { readFileSync as readFileSync2 } from "fs";
243
- import nodePath3 from "path";
244
244
  var MAX_CODE_LENGTH = 6;
245
245
  var MIN_NAME_LENGTH = 2;
246
246
  var PERSONA_CODE_PATTERN = /^[A-Z][A-Z0-9]{1,5}$/;
@@ -364,13 +364,12 @@ function validatePersonas(parsed) {
364
364
  )
365
365
  ];
366
366
  }
367
- var PERSONAS_FILE_SUBPATH = [".safeword-project", "personas.md"];
368
367
 
369
368
  // src/commands/check.ts
370
369
  function findMissingFiles(cwd, actions) {
371
370
  const issues = [];
372
371
  for (const action of actions) {
373
- if (action.type === "write" && !exists(nodePath4.join(cwd, action.path))) {
372
+ if (action.type === "write" && !exists(nodePath2.join(cwd, action.path))) {
374
373
  issues.push(`Missing: ${action.path}`);
375
374
  }
376
375
  }
@@ -378,7 +377,7 @@ function findMissingFiles(cwd, actions) {
378
377
  }
379
378
  function findPersonaIssues(cwd) {
380
379
  const override = readConfiguredPath(cwd, "personas");
381
- const filePath = resolveConfiguredPath(cwd, "personas", nodePath4.join(...PERSONAS_FILE_SUBPATH));
380
+ const filePath = resolveConfiguredPath(cwd, "personas");
382
381
  const content = readFileSafe(filePath);
383
382
  if (content === void 0) {
384
383
  if (override !== void 0) {
@@ -389,18 +388,26 @@ function findPersonaIssues(cwd) {
389
388
  const errors = validatePersonas(parsePersonas(content));
390
389
  return errors.map((error) => `personas.md:${error.line}: ${error.message}`);
391
390
  }
391
+ function findNamespaceAdvisories(cwd) {
392
+ if (isDirectory(nodePath2.join(cwd, ".project")) && isDirectory(nodePath2.join(cwd, ".safeword-project"))) {
393
+ return [
394
+ "Both .project/ and .safeword-project/ exist \u2014 safeword reads .project/. Merge any needed legacy content into .project/ and remove .safeword-project/ (or run `safeword upgrade --migrate-namespace` after removing .project/ if the legacy directory is the real one)."
395
+ ];
396
+ }
397
+ return [];
398
+ }
392
399
  function findPersonaAdvisories(cwd) {
393
400
  const override = readConfiguredPath(cwd, "personas");
394
401
  if (override === void 0) return [];
395
- const defaultPath = nodePath4.join(cwd, ...PERSONAS_FILE_SUBPATH);
402
+ const defaultPath = defaultConfiguredPath(cwd, "personas");
396
403
  if (!exists(defaultPath)) return [];
397
404
  return [
398
- `.safeword-project/personas.md exists but paths.personas points to ${override} \u2014 legacy file is orphaned. Consider removing.`
405
+ `${nodePath2.relative(cwd, defaultPath)} exists but paths.personas points to ${override} \u2014 legacy file is orphaned. Consider removing.`
399
406
  ];
400
407
  }
401
408
  function findGlossaryIssues(cwd) {
402
409
  const override = readConfiguredPath(cwd, "glossary");
403
- const filePath = resolveConfiguredPath(cwd, "glossary", nodePath4.join(...GLOSSARY_FILE_SUBPATH));
410
+ const filePath = resolveConfiguredPath(cwd, "glossary");
404
411
  const content = readFileSafe(filePath);
405
412
  if (content === void 0) {
406
413
  if (override !== void 0) {
@@ -414,13 +421,12 @@ function findGlossaryIssues(cwd) {
414
421
  function findGlossaryAdvisories(cwd) {
415
422
  const override = readConfiguredPath(cwd, "glossary");
416
423
  if (override === void 0) return [];
417
- const defaultPath = nodePath4.join(cwd, ...GLOSSARY_FILE_SUBPATH);
424
+ const defaultPath = defaultConfiguredPath(cwd, "glossary");
418
425
  if (!exists(defaultPath)) return [];
419
426
  return [
420
- `.safeword-project/glossary.md exists but paths.glossary points to ${override} \u2014 legacy file is orphaned. Consider removing.`
427
+ `${nodePath2.relative(cwd, defaultPath)} exists but paths.glossary points to ${override} \u2014 legacy file is orphaned. Consider removing.`
421
428
  ];
422
429
  }
423
- var TICKETS_SUBPATH = [".safeword-project", "tickets"];
424
430
  function listTicketIds(ticketsRoot) {
425
431
  try {
426
432
  return readdirSync2(ticketsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && entry.name !== "completed").map((entry) => entry.name);
@@ -428,17 +434,16 @@ function listTicketIds(ticketsRoot) {
428
434
  return [];
429
435
  }
430
436
  }
431
- var ARCHITECTURE_DEFAULT_SUBPATH = nodePath4.join(".safeword-project", "architecture.md");
432
437
  function findArchitectureAdvisories(cwd) {
433
- const ticketsRoot = nodePath4.join(cwd, ...TICKETS_SUBPATH);
438
+ const ticketsRoot = resolveTicketsDirectory(cwd);
434
439
  const ticketIds = listTicketIds(ticketsRoot);
435
- const resolved = resolveConfiguredPath(cwd, "architecture", ARCHITECTURE_DEFAULT_SUBPATH);
440
+ const resolved = resolveConfiguredPath(cwd, "architecture");
436
441
  if (listArchitectureRecords(resolved).kind !== "absent") return [];
437
442
  return ticketIds.flatMap((ticketId) => {
438
- const ticketDirectory = nodePath4.join(ticketsRoot, ticketId);
439
- const ticketContent = readFileSafe(nodePath4.join(ticketDirectory, "ticket.md"));
443
+ const ticketDirectory = nodePath2.join(ticketsRoot, ticketId);
444
+ const ticketContent = readFileSafe(nodePath2.join(ticketDirectory, "ticket.md"));
440
445
  if (ticketContent === void 0 || !isInProgress(ticketContent)) return [];
441
- const implPlan = readFileSafe(nodePath4.join(ticketDirectory, "impl-plan.md"));
446
+ const implPlan = readFileSafe(nodePath2.join(ticketDirectory, "impl-plan.md"));
442
447
  if (implPlan === void 0) return [];
443
448
  if (!archAlignmentHasContent(implPlan)) return [];
444
449
  return [
@@ -461,19 +466,19 @@ function archAlignmentHasContent(implPlanContent) {
461
466
  return !(body.length === 1 && (body[0] ?? "").toLowerCase().startsWith("skip:"));
462
467
  }
463
468
  function findCoverageAdvisories(cwd) {
464
- const ticketsRoot = nodePath4.join(cwd, ...TICKETS_SUBPATH);
469
+ const ticketsRoot = resolveTicketsDirectory(cwd);
465
470
  return listTicketIds(ticketsRoot).flatMap(
466
471
  (ticketId) => coverageAdvisoriesForTicket(ticketsRoot, ticketId)
467
472
  );
468
473
  }
469
474
  function coverageAdvisoriesForTicket(ticketsRoot, ticketId) {
470
- const ticketDirectory = nodePath4.join(ticketsRoot, ticketId);
471
- const ticketContent = readFileSafe(nodePath4.join(ticketDirectory, "ticket.md"));
475
+ const ticketDirectory = nodePath2.join(ticketsRoot, ticketId);
476
+ const ticketContent = readFileSafe(nodePath2.join(ticketDirectory, "ticket.md"));
472
477
  if (ticketContent === void 0 || !isInProgress(ticketContent)) return [];
473
- const specContent = readFileSafe(nodePath4.join(ticketDirectory, "spec.md"));
478
+ const specContent = readFileSafe(nodePath2.join(ticketDirectory, "spec.md"));
474
479
  if (specContent === void 0) return [];
475
480
  const testDefinitionsContent = readFileSafe(
476
- nodePath4.join(ticketDirectory, "test-definitions.md")
481
+ nodePath2.join(ticketDirectory, "test-definitions.md")
477
482
  );
478
483
  return formatCoverageReport(ticketId, buildCoverageReport(specContent, testDefinitionsContent));
479
484
  }
@@ -503,7 +508,7 @@ function formatCoverageReport(ticketId, report) {
503
508
  ];
504
509
  }
505
510
  function findRelationAdvisories(cwd) {
506
- const ticketsDirectory = nodePath4.join(cwd, ...TICKETS_SUBPATH);
511
+ const ticketsDirectory = resolveTicketsDirectory(cwd);
507
512
  let entries;
508
513
  try {
509
514
  const { active, completed } = readTickets(ticketsDirectory);
@@ -528,7 +533,7 @@ function findMissingPatches(cwd, actions) {
528
533
  const issues = [];
529
534
  for (const action of actions) {
530
535
  if (action.type !== "text-patch") continue;
531
- const fullPath = nodePath4.join(cwd, action.path);
536
+ const fullPath = nodePath2.join(cwd, action.path);
532
537
  if (exists(fullPath)) {
533
538
  const content = readFileSafe(fullPath) ?? "";
534
539
  if (action.definition && !content.includes(action.definition.marker)) {
@@ -558,7 +563,7 @@ async function checkLatestVersion(timeout = 3e3) {
558
563
  }
559
564
  }
560
565
  async function checkHealth(cwd) {
561
- const safewordDirectory = nodePath4.join(cwd, ".safeword");
566
+ const safewordDirectory = nodePath2.join(cwd, ".safeword");
562
567
  if (!exists(safewordDirectory)) {
563
568
  return {
564
569
  configured: false,
@@ -572,7 +577,7 @@ async function checkHealth(cwd) {
572
577
  missingPacks: []
573
578
  };
574
579
  }
575
- const versionPath = nodePath4.join(safewordDirectory, "version");
580
+ const versionPath = nodePath2.join(safewordDirectory, "version");
576
581
  const projectVersion = readFileSafe(versionPath)?.trim() ?? void 0;
577
582
  const ctx = createProjectContext(cwd);
578
583
  const result = await reconcile(SAFEWORD_SCHEMA, "upgrade", ctx, {
@@ -587,7 +592,7 @@ async function checkHealth(cwd) {
587
592
  ...findPersonaIssues(cwd),
588
593
  ...findGlossaryIssues(cwd)
589
594
  ];
590
- if (!exists(nodePath4.join(cwd, ".claude", "settings.json"))) {
595
+ if (!exists(nodePath2.join(cwd, ".claude", "settings.json"))) {
591
596
  issues.push("Missing: .claude/settings.json");
592
597
  }
593
598
  const missingPacks = getMissingPacks(cwd);
@@ -599,6 +604,7 @@ async function checkHealth(cwd) {
599
604
  latestVersion: void 0,
600
605
  issues,
601
606
  advisories: [
607
+ ...findNamespaceAdvisories(cwd),
602
608
  ...findPersonaAdvisories(cwd),
603
609
  ...findGlossaryAdvisories(cwd),
604
610
  ...findCoverageAdvisories(cwd),
@@ -639,6 +645,12 @@ Upgrade available for project config`);
639
645
  }
640
646
  }
641
647
  function reportHealthSummary(health) {
648
+ if (health.advisories.length > 0) {
649
+ header("Advisories");
650
+ for (const advisory of health.advisories) {
651
+ warn(advisory);
652
+ }
653
+ }
642
654
  if (health.missingPacks.length > 0) {
643
655
  header("Missing Language Packs");
644
656
  for (const pack of health.missingPacks) {
@@ -661,12 +673,6 @@ function reportHealthSummary(health) {
661
673
  info("\nRun `safeword upgrade` to repair configuration");
662
674
  return true;
663
675
  }
664
- if (health.advisories.length > 0) {
665
- header("Advisories");
666
- for (const advisory of health.advisories) {
667
- warn(advisory);
668
- }
669
- }
670
676
  success("\nConfiguration is healthy");
671
677
  return false;
672
678
  }
@@ -708,4 +714,4 @@ async function check(options) {
708
714
  export {
709
715
  check
710
716
  };
711
- //# sourceMappingURL=check-C3IEG3XA.js.map
717
+ //# sourceMappingURL=check-OP4A4UNY.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/check.ts","../src/utils/architecture-records.ts","../src/utils/glossary.ts","../src/utils/validation.ts","../src/utils/personas.ts"],"sourcesContent":["/**\n * Check command - Verify project health and configuration\n *\n * Uses reconcile() with dryRun to detect missing files and configuration issues.\n */\n\nimport { readdirSync } from 'node:fs';\nimport nodePath from 'node:path';\n\nimport { getMissingPacks } from '../packs/registry.js';\nimport { reconcile } from '../reconcile.js';\nimport { SAFEWORD_SCHEMA } from '../schema.js';\nimport { readTickets, syncTickets } from '../ticket-sync/index.js';\nimport { listArchitectureRecords } from '../utils/architecture-records.js';\nimport {\n defaultConfiguredPath,\n readConfiguredPath,\n resolveConfiguredPath,\n resolveTicketsDirectory,\n} from '../utils/configured-paths.js';\nimport { createProjectContext } from '../utils/context.js';\nimport { exists, isDirectory, readFileSafe } from '../utils/fs.js';\nimport { parseGlossary, validateGlossary } from '../utils/glossary.js';\nimport { header, info, keyValue, listItem, success, warn } from '../utils/output.js';\nimport { parsePersonas, validatePersonas } from '../utils/personas.js';\nimport { buildCoverageReport, type CoverageReport } from '../utils/scenario-coverage.js';\nimport { formatTicketReference } from '../utils/ticket-reference.js';\nimport { findDanglingDependencies, findTicketsInCycles } from '../utils/ticket-relations.js';\nimport { isNewerVersion } from '../utils/version.js';\nimport { VERSION } from '../version.js';\n\ninterface CheckOptions {\n offline?: boolean;\n}\n\n/**\n * Check for missing files from write actions\n * @param cwd\n * @param actions\n */\nfunction findMissingFiles(cwd: string, actions: { type: string; path: string }[]): string[] {\n const issues: string[] = [];\n for (const action of actions) {\n if (action.type === 'write' && !exists(nodePath.join(cwd, action.path))) {\n issues.push(`Missing: ${action.path}`);\n }\n }\n return issues;\n}\n\n// The persona/glossary find*Issues + find*Advisories pairs below (and the\n// validate*Reference / lookup* pairs in personas.ts / glossary.ts) are\n// intentionally parallel, NOT a missed extraction: the cores diverge (persona\n// matches code/name, glossary matches name/alias; different parse+validate\n// fns and messages), and where they don't, deduping two call sites into a\n// multi-param helper would cost clarity. Assessed in ticket XEP59N — leave as is.\n\n/**\n * Validate personas.md when present, routing through any configured\n * `paths.personas` override. Returns one issue string per persona\n * validation error, formatted as `personas.md:LINE: MESSAGE`.\n *\n * Two failure modes:\n * - Default location absent → no issue (scaffold is optional until JTBDs\n * reference personas).\n * - Configured override set but file absent → loud failure (user opted\n * in; typo would otherwise silently strand persona references). Ticket\n * K7N2QM.\n */\nfunction findPersonaIssues(cwd: string): string[] {\n const override = readConfiguredPath(cwd, 'personas');\n const filePath = resolveConfiguredPath(cwd, 'personas');\n const content = readFileSafe(filePath);\n\n if (content === undefined) {\n if (override !== undefined) {\n return [`personas-path: ${override}: file not found`];\n }\n return [];\n }\n\n const errors = validatePersonas(parsePersonas(content));\n return errors.map(error => `personas.md:${error.line}: ${error.message}`);\n}\n\n/**\n * Surface non-blocking diagnostics about persona path configuration.\n * Currently: when `paths.personas` is set AND the default-location file\n * the default personas file still exists, emit an advisory naming\n * the orphaned file. Safeword reads from the override; the legacy file\n * is dead weight and may confuse readers who think they're editing the\n * live file. Zero-exit — non-destructive (data-loss principle from\n * ticket K7N2QM); user owns cleanup.\n */\n/**\n * Both-namespace-roots advisory (ticket 9MMWS7): both `.project/` and\n * `.safeword-project/` present means a migration was left half-finished (or\n * the dirs were created independently). Zero-exit nudge naming the finishing\n * action; silent on any single root — declining migration is never a nag.\n */\nfunction findNamespaceAdvisories(cwd: string): string[] {\n if (\n isDirectory(nodePath.join(cwd, '.project')) &&\n isDirectory(nodePath.join(cwd, '.safeword-project'))\n ) {\n return [\n 'Both .project/ and .safeword-project/ exist — safeword reads .project/. Merge any needed legacy content into .project/ and remove .safeword-project/ (or run `safeword upgrade --migrate-namespace` after removing .project/ if the legacy directory is the real one).',\n ];\n }\n return [];\n}\n\nfunction findPersonaAdvisories(cwd: string): string[] {\n const override = readConfiguredPath(cwd, 'personas');\n if (override === undefined) return [];\n const defaultPath = defaultConfiguredPath(cwd, 'personas');\n if (!exists(defaultPath)) return [];\n return [\n `${nodePath.relative(cwd, defaultPath)} exists but paths.personas points to ${override} — legacy file is orphaned. Consider removing.`,\n ];\n}\n\n/**\n * Validate glossary.md when present, routing through any configured\n * `paths.glossary` override. Returns one issue string per glossary\n * validation error, formatted as `glossary.md:LINE: MESSAGE`. Same two\n * failure modes as {@link findPersonaIssues} — absent default is silent\n * (scaffold is optional), configured-but-missing fails loudly (ticket\n * YR6C49, mirrors K7N2QM).\n */\nfunction findGlossaryIssues(cwd: string): string[] {\n const override = readConfiguredPath(cwd, 'glossary');\n const filePath = resolveConfiguredPath(cwd, 'glossary');\n const content = readFileSafe(filePath);\n\n if (content === undefined) {\n if (override !== undefined) {\n return [`glossary-path: ${override}: file not found`];\n }\n return [];\n }\n\n const errors = validateGlossary(parseGlossary(content));\n return errors.map(error => `glossary.md:${error.line}: ${error.message}`);\n}\n\n/**\n * Surface non-blocking diagnostics about glossary path configuration.\n * When `paths.glossary` is set AND the default-location file still exists,\n * emit a zero-exit advisory naming the orphaned file (mirrors\n * {@link findPersonaAdvisories}; data-loss principle from K7N2QM).\n */\nfunction findGlossaryAdvisories(cwd: string): string[] {\n const override = readConfiguredPath(cwd, 'glossary');\n if (override === undefined) return [];\n const defaultPath = defaultConfiguredPath(cwd, 'glossary');\n if (!exists(defaultPath)) return [];\n return [\n `${nodePath.relative(cwd, defaultPath)} exists but paths.glossary points to ${override} — legacy file is orphaned. Consider removing.`,\n ];\n}\n\n/** Ticket folder names under the tickets root (excluding `completed/`), or\n * empty when the root is missing/unreadable. */\nfunction listTicketIds(ticketsRoot: string): string[] {\n try {\n return readdirSync(ticketsRoot, { withFileTypes: true })\n .filter(entry => entry.isDirectory() && entry.name !== 'completed')\n .map(entry => entry.name);\n } catch {\n return [];\n }\n}\n\n/**\n * Surface architecture-claim mismatches as non-blocking advisories (ticket\n * K4BWTQ). Structural only — no prose extraction (YR6C49 ruling): when an\n * in-progress ticket's impl-plan.md Arch alignment section carries content\n * (not `skip:`) but the resolved `paths.architecture` location does not\n * exist, the claim cannot be honoring anything recorded. Zero-exit.\n */\nfunction findArchitectureAdvisories(cwd: string): string[] {\n const ticketsRoot = resolveTicketsDirectory(cwd);\n const ticketIds = listTicketIds(ticketsRoot);\n\n const resolved = resolveConfiguredPath(cwd, 'architecture');\n if (listArchitectureRecords(resolved).kind !== 'absent') return [];\n\n return ticketIds.flatMap(ticketId => {\n const ticketDirectory = nodePath.join(ticketsRoot, ticketId);\n const ticketContent = readFileSafe(nodePath.join(ticketDirectory, 'ticket.md'));\n if (ticketContent === undefined || !isInProgress(ticketContent)) return [];\n const implPlan = readFileSafe(nodePath.join(ticketDirectory, 'impl-plan.md'));\n if (implPlan === undefined) return [];\n if (!archAlignmentHasContent(implPlan)) return [];\n return [\n `${ticketId}: impl-plan.md Arch alignment claims alignment, but no architecture record exists at ${resolved} — record the decision or mark the section skip:`,\n ];\n });\n}\n\n/** Whether the impl plan's `## Arch alignment` section carries real content\n * (non-empty, not a `skip:` annotation). */\nfunction archAlignmentHasContent(implPlanContent: string): boolean {\n let inSection = false;\n const body: string[] = [];\n for (const raw of implPlanContent.split('\\n')) {\n const line = raw.trim();\n if (line.startsWith('## ')) {\n inSection = line.slice(3).trim().toLowerCase() === 'arch alignment';\n continue;\n }\n if (inSection && line !== '') body.push(line);\n }\n if (body.length === 0) return false;\n return !(body.length === 1 && (body[0] ?? '').toLowerCase().startsWith('skip:'));\n}\n\n/**\n * Surface scenario-lineage coverage gaps as non-blocking advisories (ticket\n * XT1FFM). Scoped to `status: in_progress` tickets that carry a spec.md —\n * which excludes done predecessors whose pre-scheme scenarios are the\n * out-of-scope migration case (epic DZ2NM5/D5), and keeps the report focused\n * on the work the developer is actually building. Each in-progress ticket's\n * (spec.md, test-definitions.md) pair is cross-referenced into uncovered ACs,\n * stale AC refs, and orphan scenarios. Zero-exit — advisory, never a gate.\n */\nfunction findCoverageAdvisories(cwd: string): string[] {\n const ticketsRoot = resolveTicketsDirectory(cwd);\n return listTicketIds(ticketsRoot).flatMap(ticketId =>\n coverageAdvisoriesForTicket(ticketsRoot, ticketId),\n );\n}\n\n/** Build coverage advisories for one ticket, or none if it is not an\n * in-progress, spec-bearing ticket. */\nfunction coverageAdvisoriesForTicket(ticketsRoot: string, ticketId: string): string[] {\n const ticketDirectory = nodePath.join(ticketsRoot, ticketId);\n const ticketContent = readFileSafe(nodePath.join(ticketDirectory, 'ticket.md'));\n if (ticketContent === undefined || !isInProgress(ticketContent)) return [];\n\n const specContent = readFileSafe(nodePath.join(ticketDirectory, 'spec.md'));\n if (specContent === undefined) return [];\n\n const testDefinitionsContent = readFileSafe(\n nodePath.join(ticketDirectory, 'test-definitions.md'),\n );\n return formatCoverageReport(ticketId, buildCoverageReport(specContent, testDefinitionsContent));\n}\n\n/** Whether a ticket.md's frontmatter declares `status: in_progress`. */\nfunction isInProgress(ticketContent: string): boolean {\n const lines = ticketContent.split('\\n');\n if (lines[0]?.trim() !== '---') return false;\n for (let index = 1; index < lines.length; index += 1) {\n const line = (lines[index] ?? '').trim();\n if (line === '---') return false;\n if (line === 'status: in_progress') return true;\n }\n return false;\n}\n\n/** Render a coverage report into one advisory string per finding. */\nfunction formatCoverageReport(ticketId: string, report: CoverageReport): string[] {\n const dashIndex = ticketId.indexOf('-');\n const ticketLabel =\n dashIndex === -1\n ? ticketId\n : formatTicketReference(ticketId.slice(0, dashIndex), ticketId.slice(dashIndex + 1));\n return [\n ...report.uncovered.map(\n acId => `${ticketLabel}: acceptance criterion ${acId} has no scenario (uncovered)`,\n ),\n ...report.stale.map(\n reference =>\n `${ticketLabel}: scenario ref ${reference} matches no AC under its JTBD (stale ref)`,\n ),\n ...report.orphan.map(\n reference => `${ticketLabel}: scenario ref ${reference} names no JTBD in spec.md (orphan)`,\n ),\n ];\n}\n\n/**\n * Surface structured-relation problems as non-blocking advisories (ticket\n * AKZJXC): a `depends_on` pointing at a ticket absent from the corpus (dangling\n * ref), and dependency cycles (A→B→A). Warn-only — a target may live on another\n * branch or in completed/, and a cycle is a planning smell, not a config fault.\n * Reads the full corpus (active + completed) so cross-status edges resolve.\n * Zero-exit.\n */\nfunction findRelationAdvisories(cwd: string): string[] {\n const ticketsDirectory = resolveTicketsDirectory(cwd);\n let entries;\n try {\n const { active, completed } = readTickets(ticketsDirectory);\n entries = [...active, ...completed];\n } catch {\n return [];\n }\n\n const nodes = entries.map(entry => ({ id: entry.id, dependsOn: entry.dependsOn }));\n const labelById = new Map(entries.map(entry => [entry.id, entry.title]));\n const refOf = (id: string): string => {\n const title = labelById.get(id);\n return title === undefined ? id : formatTicketReference(id, title);\n };\n\n const dangling = findDanglingDependencies(nodes).map(\n ({ from, missing }) => `${refOf(from)}: depends_on ${missing} — no such ticket (dangling ref)`,\n );\n const cyclic = findTicketsInCycles(nodes);\n const cycle =\n cyclic.length > 0\n ? [`dependency cycle among: ${cyclic.map(id => refOf(id)).join(', ')} (break the loop)`]\n : [];\n return [...dangling, ...cycle];\n}\n\n/**\n * Check for missing text patch markers\n * @param cwd\n * @param actions\n */\nfunction findMissingPatches(\n cwd: string,\n actions: { type: string; path: string; definition?: { marker: string } }[],\n): string[] {\n const issues: string[] = [];\n for (const action of actions) {\n if (action.type !== 'text-patch') continue;\n\n const fullPath = nodePath.join(cwd, action.path);\n if (exists(fullPath)) {\n const content = readFileSafe(fullPath) ?? '';\n if (action.definition && !content.includes(action.definition.marker)) {\n issues.push(`${action.path} missing safeword link`);\n }\n } else {\n issues.push(`${action.path} file missing`);\n }\n }\n return issues;\n}\n\ninterface HealthStatus {\n configured: boolean;\n projectVersion: string | undefined;\n cliVersion: string;\n updateAvailable: boolean;\n latestVersion: string | undefined;\n issues: string[];\n /**\n * Non-blocking diagnostics — reported to the user but do NOT gate\n * non-zero exit. Use for situations where safeword's operation is\n * unaffected but a cleanup or attention is warranted (e.g., legacy\n * default-location file orphaned by a configured `paths.*` override).\n */\n advisories: string[];\n missingPackages: string[];\n missingPacks: string[];\n}\n\n/**\n * Check for latest version from npm (with timeout)\n * @param timeout\n */\nasync function checkLatestVersion(timeout = 3000): Promise<string | undefined> {\n try {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => {\n controller.abort();\n }, timeout);\n\n const response = await fetch('https://registry.npmjs.org/safeword/latest', {\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) return undefined;\n\n const data = (await response.json()) as { version?: string };\n return data.version ?? undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Check project configuration health using reconcile dryRun\n * @param cwd\n */\nasync function checkHealth(cwd: string): Promise<HealthStatus> {\n const safewordDirectory = nodePath.join(cwd, '.safeword');\n\n // Check if configured\n if (!exists(safewordDirectory)) {\n return {\n configured: false,\n projectVersion: undefined,\n cliVersion: VERSION,\n updateAvailable: false,\n latestVersion: undefined,\n issues: [],\n advisories: [],\n missingPackages: [],\n missingPacks: [],\n };\n }\n\n // Read project version\n const versionPath = nodePath.join(safewordDirectory, 'version');\n const projectVersion = readFileSafe(versionPath)?.trim() ?? undefined;\n\n // Use reconcile with dryRun to detect issues\n const ctx = createProjectContext(cwd);\n const result = await reconcile(SAFEWORD_SCHEMA, 'upgrade', ctx, {\n dryRun: true,\n });\n\n // Collect issues from write actions and text patches\n // Filter out chmod (paths[] instead of path) and json-merge/unmerge (incompatible definition)\n const actionsWithPath = result.actions.filter(\n (\n a,\n ): a is Exclude<\n (typeof result.actions)[number],\n { type: 'chmod' } | { type: 'json-merge' } | { type: 'json-unmerge' }\n > => a.type !== 'chmod' && a.type !== 'json-merge' && a.type !== 'json-unmerge',\n );\n const issues: string[] = [\n ...findMissingFiles(cwd, actionsWithPath),\n ...findMissingPatches(cwd, actionsWithPath),\n ...findPersonaIssues(cwd),\n ...findGlossaryIssues(cwd),\n ];\n\n // Check for missing .claude/settings.json\n if (!exists(nodePath.join(cwd, '.claude', 'settings.json'))) {\n issues.push('Missing: .claude/settings.json');\n }\n\n // Check for missing language packs\n const missingPacks = getMissingPacks(cwd);\n\n return {\n configured: true,\n projectVersion,\n cliVersion: VERSION,\n updateAvailable: false,\n latestVersion: undefined,\n issues,\n advisories: [\n ...findNamespaceAdvisories(cwd),\n ...findPersonaAdvisories(cwd),\n ...findGlossaryAdvisories(cwd),\n ...findCoverageAdvisories(cwd),\n ...findRelationAdvisories(cwd),\n ...findArchitectureAdvisories(cwd),\n ],\n missingPackages: result.packagesToInstall,\n missingPacks,\n };\n}\n\n/**\n * Check for CLI updates and report status\n * @param health\n */\nasync function reportUpdateStatus(health: HealthStatus): Promise<void> {\n info('\\nChecking for updates...');\n const latestVersion = await checkLatestVersion();\n\n if (!latestVersion) {\n warn(\"Couldn't check for updates (offline?)\");\n return;\n }\n\n health.latestVersion = latestVersion;\n health.updateAvailable = isNewerVersion(health.cliVersion, latestVersion);\n\n if (health.updateAvailable) {\n warn(`Update available: v${latestVersion}`);\n info('Run `bunx safeword@latest upgrade` to upgrade');\n } else {\n success('CLI is up to date');\n }\n}\n\n/**\n * Compare project version vs CLI version and report\n * @param health\n */\nfunction reportVersionMismatch(health: HealthStatus): void {\n if (!health.projectVersion) return;\n\n if (isNewerVersion(health.cliVersion, health.projectVersion)) {\n warn(`Project config (v${health.projectVersion}) is newer than CLI (v${health.cliVersion})`);\n info('Consider upgrading the CLI');\n } else if (isNewerVersion(health.projectVersion, health.cliVersion)) {\n info(`\\nUpgrade available for project config`);\n info(\n `Run \\`safeword upgrade\\` to update from v${health.projectVersion} to v${health.cliVersion}`,\n );\n }\n}\n\n/**\n * Report issues or success\n * @param health\n * @returns true if there are issues requiring attention\n */\nfunction reportHealthSummary(health: HealthStatus): boolean {\n // Advisories first: non-blocking diagnostics that must surface even when\n // issues exist (the issue branches below early-return). Ticket 9MMWS7\n // exposed the old ordering, which silently swallowed advisories on any\n // unhealthy project.\n if (health.advisories.length > 0) {\n header('Advisories');\n for (const advisory of health.advisories) {\n warn(advisory);\n }\n }\n\n // Check missing packs first (highest priority - explains missing files)\n if (health.missingPacks.length > 0) {\n header('Missing Language Packs');\n for (const pack of health.missingPacks) {\n listItem(`${pack} pack not installed`);\n }\n info('\\nRun `safeword upgrade` to install missing packs');\n return true;\n }\n\n if (health.missingPackages.length > 0) {\n header('Missing Packages');\n for (const pkg of health.missingPackages) listItem(pkg);\n info('\\nRun `safeword upgrade` to install missing packages');\n return true;\n }\n\n if (health.issues.length > 0) {\n header('Issues Found');\n for (const issue of health.issues) {\n warn(issue);\n }\n info('\\nRun `safeword upgrade` to repair configuration');\n return true;\n }\n\n success('\\nConfiguration is healthy');\n return false;\n}\n\n/**\n * Regenerate the ticket discovery index, swallowing any error — index\n * freshness must never block or fail a health check. Reports only when it\n * actually rewrote a file.\n * @param cwd\n */\nfunction regenerateTicketIndex(cwd: string): void {\n try {\n const result = syncTickets(cwd);\n if (result.wrote) {\n info('Regenerated ticket index (INDEX.md / INDEX-completed.md)');\n }\n } catch (error: unknown) {\n // Best-effort: index freshness must never fail the health check. Surface\n // under DEBUG, then return — the deliberate swallow point.\n if (process.env.DEBUG) {\n console.error('[check] ticket index regen failed:', error);\n }\n return;\n }\n}\n\n/**\n *\n * @param options\n */\nexport async function check(options: CheckOptions): Promise<void> {\n const cwd = process.cwd();\n\n header('Safeword Health Check');\n\n const health = await checkHealth(cwd);\n\n // Not configured\n if (!health.configured) {\n info('Not configured. Run `safeword setup` to initialize.');\n return;\n }\n\n // Keep the ticket discovery index fresh at this checkpoint (best-effort —\n // never fail the health check on index regen). Ticket 1GGD28.\n regenerateTicketIndex(cwd);\n\n // Show versions\n keyValue('Safeword CLI', `v${health.cliVersion}`);\n keyValue('Project config', health.projectVersion ? `v${health.projectVersion}` : 'unknown');\n\n // Check for updates (unless offline)\n if (options.offline) {\n info('\\nSkipped update check (offline mode)');\n } else {\n await reportUpdateStatus(health);\n }\n\n reportVersionMismatch(health);\n const hasIssues = reportHealthSummary(health);\n\n if (hasIssues) {\n process.exit(1);\n }\n}\n","/**\n * Lists a project's architecture records (ticket K4BWTQ).\n *\n * The resolved `paths.architecture` location may be a single markdown file\n * (the architecture record itself) or a directory of ADRs — each top-level\n * `.md` file except README.md, accept-any naming, no recursion. See the\n * M6D315 replan for why this reuses `paths.architecture` instead of a\n * separate ADR-location field.\n */\n\nimport { readdirSync, statSync } from 'node:fs';\nimport nodePath from 'node:path';\n\ntype ArchitectureLocationKind = 'file' | 'directory' | 'absent';\n\nexport interface ArchitectureRecords {\n kind: ArchitectureLocationKind;\n /** Absolute paths of the record files; empty when none exist. */\n records: string[];\n}\n\nexport function listArchitectureRecords(resolvedPath: string): ArchitectureRecords {\n // try/catch in addition to throwIfNoEntry: statSync still throws ENOTDIR\n // when a path *component* is a file (nodejs/node#56993) — reachable here\n // via a misconfigured paths.architecture; treat it as absent, not a crash.\n let stats;\n try {\n stats = statSync(resolvedPath, { throwIfNoEntry: false });\n } catch {\n return { kind: 'absent', records: [] };\n }\n if (stats?.isFile()) {\n return { kind: 'file', records: [resolvedPath] };\n }\n if (stats?.isDirectory()) {\n const records = readdirSync(resolvedPath, { withFileTypes: true })\n .filter(entry => entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md')\n .map(entry => nodePath.join(resolvedPath, entry.name));\n return { kind: 'directory', records };\n }\n return { kind: 'absent', records: [] };\n}\n","/**\n * Glossary file model — parsing, validation, and lookup.\n *\n * Project-level glossary lives at the resolved namespace root (or the\n * path configured at `paths.glossary` in `.safeword/config.json`). Each\n * entry is a level-2 markdown block with a `## Term` header, a required\n * `**Definition:**` line, and optional `**Used in:**`, `**Example:**`,\n * `**Do not confuse with:**`, and `**Aliases:**` lines.\n *\n * Schema is intentionally lenient — unknown `**Field:**` lines are\n * tolerated for forward-compat, and the arcade-prototype\n * `**Used in**:` (colon outside the bold) variant parses identically\n * to `**Used in:**`. The required schema is just `## Term` + Definition;\n * everything else evolves per-team.\n *\n * See ticket YR6C49 for the full spec.\n */\n\nimport { readFileSync } from 'node:fs';\n\nimport { resolveConfiguredPath } from './configured-paths.js';\nimport { computeSkipMask, stripInlineComments } from './markdown-sections.js';\nimport { findDuplicates, groupByLine } from './validation.js';\n\n/**\n * A parsed glossary entry — name + Definition (required), plus any\n * optional fields the entry authored. Aliases is always present\n * (possibly empty) so callers can iterate without an optional-chain.\n */\nexport interface ParsedGlossaryEntry {\n name: string;\n definition: string;\n usedIn?: string;\n example?: string;\n doNotConfuseWith?: string;\n aliases: string[];\n /** 1-indexed line number of the `## ` header. */\n lineNumber: number;\n}\n\n/** A validation error with a 1-indexed line reference into the source content. */\nexport interface GlossaryValidationError {\n line: number;\n message: string;\n}\n\n/**\n * Result of resolving a glossary reference against the parsed entries.\n *\n * Discriminated union — `match` is guaranteed when `status === 'valid'`;\n * `suggestion` is only meaningful when `status === 'unknown'`. Callers\n * narrow on `status` without optional chaining.\n */\nexport type GlossaryReferenceResult =\n | { status: 'valid'; match: ParsedGlossaryEntry }\n | { status: 'unknown'; suggestion?: string };\n\n/**\n * Resolve a glossary reference against the on-disk glossary file.\n *\n * Reads from `paths.glossary` in `.safeword/config.json` when configured;\n * falls back to the namespace-root default otherwise. Degrades\n * gracefully on a missing or unreadable file — returns\n * `{ status: 'unknown' }` rather than throwing, regardless of whether the\n * resolved path is the default or a configured override. The loud signal\n * on configured-but-missing lives in `safeword check`, not here — keep\n * this lookup cheap and side-effect-free (mirrors\n * `validatePersonaReference`, ticket K7N2QM).\n */\nexport function validateGlossaryReference(cwd: string, input: string): GlossaryReferenceResult {\n let content: string;\n try {\n const filePath = resolveConfiguredPath(cwd, 'glossary');\n content = readFileSync(filePath, 'utf8');\n } catch {\n return { status: 'unknown' };\n }\n return lookupGlossaryReference(parseGlossary(content), input);\n}\n\n/**\n * Look up a glossary reference against parsed entries.\n *\n * Match priority: exact term name → exact alias → casing-mismatch\n * suggestion → unknown. Pure — no I/O.\n */\nexport function lookupGlossaryReference(\n entries: readonly ParsedGlossaryEntry[],\n input: string,\n): GlossaryReferenceResult {\n if (input.length === 0) return { status: 'unknown' };\n\n for (const entry of entries) {\n if (entry.name === input || entry.aliases.includes(input)) {\n return { status: 'valid', match: entry };\n }\n }\n\n // Casing-mismatch detection — suggest the canonical spelling when the\n // only difference is case (on a term name or an alias).\n const lowered = input.toLowerCase();\n for (const entry of entries) {\n if (entry.name.toLowerCase() === lowered) {\n return { status: 'unknown', suggestion: entry.name };\n }\n const aliasMatch = entry.aliases.find(alias => alias.toLowerCase() === lowered);\n if (aliasMatch !== undefined) {\n return { status: 'unknown', suggestion: entry.name };\n }\n }\n\n return { status: 'unknown' };\n}\n\n/**\n * Group alias → header line numbers across all entries. Unlike\n * {@link groupByLine} (one key per entry), each entry contributes one key\n * per declared alias.\n */\nfunction groupAliasesByLine(entries: readonly ParsedGlossaryEntry[]): Map<string, number[]> {\n const grouped = new Map<string, number[]>();\n for (const entry of entries) {\n for (const alias of entry.aliases) {\n if (alias.length === 0) continue;\n const lines = grouped.get(alias) ?? [];\n lines.push(entry.lineNumber);\n grouped.set(alias, lines);\n }\n }\n return grouped;\n}\n\n/**\n * Flag aliases that collide with a declared term name. Lookup must\n * resolve a string to exactly one term; an alias that shadows a real\n * term name is ambiguous. A self-alias (alias equal to its own term's\n * name) is harmless redundancy and not flagged.\n */\nfunction findAliasShadowingTerms(\n entries: readonly ParsedGlossaryEntry[],\n): GlossaryValidationError[] {\n const termLines = new Map<string, number>();\n for (const entry of entries) {\n if (entry.name.length > 0 && !termLines.has(entry.name)) {\n termLines.set(entry.name, entry.lineNumber);\n }\n }\n const errors: GlossaryValidationError[] = [];\n for (const entry of entries) {\n for (const alias of entry.aliases) {\n const termLine = termLines.get(alias);\n if (termLine !== undefined && termLine !== entry.lineNumber) {\n errors.push({\n line: entry.lineNumber,\n message: `alias \"${alias}\" shadows term defined at line ${termLine}`,\n });\n }\n }\n }\n return errors;\n}\n\n/**\n * Validate parsed glossary entries. Returns a list of\n * {@link GlossaryValidationError} with 1-indexed line numbers; empty list\n * means the file is well-formed.\n *\n * Checks (each independent, all errors collected — never throws):\n * - Every entry has a non-empty term name.\n * - Every entry has a non-empty `**Definition:**`.\n * - Term names are unique within the file.\n * - Aliases are unique across all terms.\n * - No alias shadows a declared term name (ambiguous lookup).\n */\nexport function validateGlossary(\n entries: readonly ParsedGlossaryEntry[],\n): GlossaryValidationError[] {\n const errors: GlossaryValidationError[] = [];\n for (const entry of entries) {\n if (entry.name.length === 0) {\n errors.push({ line: entry.lineNumber, message: 'header is missing term name' });\n }\n if (entry.definition.trim().length === 0) {\n const label = entry.name.length === 0 ? 'entry' : `\"${entry.name}\"`;\n errors.push({ line: entry.lineNumber, message: `${label} is missing Definition` });\n }\n }\n errors.push(\n ...findDuplicates(\n groupByLine(entries, entry => entry.name),\n 'term',\n ),\n ...findDuplicates(groupAliasesByLine(entries), 'alias'),\n ...findAliasShadowingTerms(entries),\n );\n return errors;\n}\n\n/**\n * The string-valued fields a `**Field:**` line can populate. Aliases is\n * excluded — it parses to an array and does not accumulate across lines.\n */\ntype StringFieldKey = 'definition' | 'usedIn' | 'example' | 'doNotConfuseWith';\n\n/**\n * Maps a `**Field:**` prefix to the corresponding property on\n * `ParsedGlossaryEntry`. Lookup is by exact-prefix; unknown prefixes are\n * silently ignored (forward-compat per ticket scope).\n */\nconst FIELD_PROPERTY_MAP: ReadonlyMap<string, StringFieldKey> = new Map([\n ['**Definition:**', 'definition'],\n ['**Used in:**', 'usedIn'],\n ['**Example:**', 'example'],\n ['**Do not confuse with:**', 'doNotConfuseWith'],\n]);\n\n/**\n * Normalize the colon-outside variant `**Foo**:` to the canonical\n * colon-inside form `**Foo:**` so a single prefix lookup table covers\n * both. Arcade's prototype glossary mixes both conventions on adjacent\n * lines — the parser must tolerate either.\n *\n * Bounded: only inspects the leading `**...**:` segment; no backtracking.\n */\nfunction normalizeFieldColon(line: string): string {\n if (!line.startsWith('**')) return line;\n const closeBold = line.indexOf('**', 2);\n if (closeBold === -1) return line;\n if (line.charAt(closeBold + 2) !== ':') return line;\n // Splice: `<prefix>**` + `:**` + `<rest after `**:`>` →\n // `**Foo**: bar` becomes `**Foo:** bar`.\n return `${line.slice(0, closeBold)}:**${line.slice(closeBold + 3)}`;\n}\n\n/**\n * If the line begins with one of the known `**Field:**` prefixes, return\n * the property + value to assign. Otherwise return undefined.\n */\nfunction parseFieldLine(line: string): { property: StringFieldKey; value: string } | undefined {\n const normalized = normalizeFieldColon(line);\n for (const [prefix, property] of FIELD_PROPERTY_MAP) {\n if (normalized.startsWith(prefix)) {\n return { property, value: normalized.slice(prefix.length).trim() };\n }\n }\n return undefined;\n}\n\n/**\n * Whether a line looks like a `**Field:**` declaration (known or not).\n * Used to terminate continuation accumulation on an unknown field line\n * so it isn't swallowed into the previous field's value. Accepts the\n * colon-outside variant via normalization first.\n */\nfunction looksLikeFieldDeclaration(line: string): boolean {\n const normalized = normalizeFieldColon(line);\n if (!normalized.startsWith('**')) return false;\n // Require non-empty content between the opening `**` and the `:**` close.\n return normalized.indexOf(':**') > 2;\n}\n\n/**\n * Parse the comma-separated alias list from a `**Aliases:** foo, bar` line.\n * Empty trailing-whitespace yields an empty list. Returns undefined when\n * the line isn't an Aliases line.\n */\nfunction parseAliasLine(line: string): string[] | undefined {\n if (!line.startsWith('**Aliases:**')) return undefined;\n const raw = line.slice('**Aliases:**'.length).trim();\n return raw.length === 0 ? [] : raw.split(',').map(part => part.trim());\n}\n\n/**\n * Outcome of applying one line to the active entry:\n * - `field` — a string field was set; the caller accumulates continuation\n * lines into `field`.\n * - `aliases` — the aliases line was consumed; stop accumulating.\n * - `none` — no known prefix matched; the line is a continuation candidate.\n */\ntype LineOutcome =\n | { kind: 'field'; field: StringFieldKey }\n | { kind: 'aliases' }\n | { kind: 'none' };\n\n/**\n * Apply a recognized field/alias line to the active entry. Unknown\n * `**Field:**` lines are tolerated per ticket scope (returns `none`).\n */\nfunction applyLineToEntry(line: string, entry: ParsedGlossaryEntry): LineOutcome {\n const aliases = parseAliasLine(line);\n if (aliases !== undefined) {\n entry.aliases = aliases;\n return { kind: 'aliases' };\n }\n const field = parseFieldLine(line);\n if (field) {\n entry[field.property] = field.value;\n return { kind: 'field', field: field.property };\n }\n return { kind: 'none' };\n}\n\n/**\n * Append a continuation line to the active string field, soft-wrap style:\n * single space between the existing text and the trimmed continuation.\n */\nfunction appendContinuation(entry: ParsedGlossaryEntry, field: StringFieldKey, line: string): void {\n const existing = entry[field] ?? '';\n const addition = line.trim();\n entry[field] = existing.length === 0 ? addition : `${existing} ${addition}`;\n}\n\n/**\n * Apply one body line (a line within a `## Term` block) to the active\n * entry and return the field that should accumulate subsequent\n * continuation lines. A blank line, an aliases line, or an unknown\n * `**Field:**` declaration resets accumulation (returns undefined).\n */\nfunction consumeBodyLine(\n line: string,\n entry: ParsedGlossaryEntry,\n activeField: StringFieldKey | undefined,\n): StringFieldKey | undefined {\n if (line.trim().length === 0) return undefined;\n const outcome = applyLineToEntry(line, entry);\n if (outcome.kind === 'field') return outcome.field;\n if (outcome.kind === 'aliases' || looksLikeFieldDeclaration(line)) return undefined;\n if (activeField !== undefined) appendContinuation(entry, activeField, line);\n return activeField;\n}\n\n/**\n * If the line is a level-2 header (`## Name`, or a bare/empty `##`),\n * return the (possibly empty) term name with inline comments stripped.\n * Returns undefined for non-header lines. An empty name is surfaced as a\n * validation error downstream, not dropped here — so the bad line still\n * produces an entry the validator can point at.\n */\nfunction parseTermHeader(line: string): string | undefined {\n if (line === '##') return '';\n if (line.startsWith('## ')) return stripInlineComments(line.slice(3)).trim();\n return undefined;\n}\n\n/**\n * Parse glossary entries from markdown content.\n *\n * Walks lines once, tracking the active `## Term` block. Skip-mask hides\n * fenced code and block HTML comments. Inline HTML comments are stripped\n * from header text before name extraction. Known `**Field:**` lines (plus\n * the arcade colon-outside variant) populate the matching property on the\n * active entry; unknown `**Field:**` lines are silently tolerated. Pure\n * — no I/O.\n */\nexport function parseGlossary(content: string): ParsedGlossaryEntry[] {\n const lines = content.split('\\n');\n const skip = computeSkipMask(lines);\n const entries: ParsedGlossaryEntry[] = [];\n let current: ParsedGlossaryEntry | undefined;\n // The field currently accumulating continuation lines. Reset on a blank\n // line, a new `## ` header, or an aliases line.\n let activeField: StringFieldKey | undefined;\n\n for (const [index, line] of lines.entries()) {\n if (skip[index]) continue;\n const headerName = parseTermHeader(line);\n if (headerName !== undefined) {\n if (current) entries.push(current);\n current = {\n name: headerName,\n definition: '',\n aliases: [],\n lineNumber: index + 1,\n };\n activeField = undefined;\n continue;\n }\n if (!current) continue;\n activeField = consumeBodyLine(line, current, activeField);\n }\n\n if (current) entries.push(current);\n return entries;\n}\n","/**\n * Shared validation helpers for the `## `-block file models (personas,\n * glossary). Both group parsed entries by a key and flag duplicates with a\n * uniform `duplicate <kind> \"<value>\" (also at line <others>)` message.\n * Extracted per ticket JZXVKN (Rule of Three, after WQ4RH3's skip-mask lift).\n */\n\n/** A validation finding with a 1-indexed line reference into the source. */\nexport interface ValidationIssue {\n line: number;\n message: string;\n}\n\n/**\n * Group entries by a derived key → the 1-indexed header line numbers that\n * produced it. Empty keys are skipped. Works for any parsed entry carrying a\n * `lineNumber` (ParsedPersona, ParsedGlossaryEntry, …).\n */\nexport function groupByLine<T extends { lineNumber: number }>(\n entries: readonly T[],\n pick: (entry: T) => string,\n): Map<string, number[]> {\n const grouped = new Map<string, number[]>();\n for (const entry of entries) {\n const key = pick(entry);\n if (key.length === 0) continue;\n const lines = grouped.get(key) ?? [];\n lines.push(entry.lineNumber);\n grouped.set(key, lines);\n }\n return grouped;\n}\n\n/**\n * Produce duplicate-detection issues from a grouping (key → header line\n * numbers): every key with more than one line yields one issue per line,\n * naming the others. `kind` labels the value class (e.g. \"persona name\",\n * \"persona code\", \"term\", \"alias\").\n */\nexport function findDuplicates(grouped: Map<string, number[]>, kind: string): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n for (const [value, lines] of grouped.entries()) {\n if (lines.length <= 1) continue;\n for (const line of lines) {\n const others = lines.filter(other => other !== line).join(', ');\n issues.push({ line, message: `duplicate ${kind} \"${value}\" (also at line ${others})` });\n }\n }\n return issues;\n}\n","/**\n * Persona file model — derivation, parsing, validation, and lookup.\n *\n * Project-level personas live at the resolved namespace root as\n * second-level markdown blocks. Each block has a name, an optional\n * parenthesized short code (auto-derived if absent), a `**Role:**` line,\n * and an optional `**Context:**` block.\n *\n * Short codes follow the pattern `^[A-Z][A-Z0-9]{1,5}$` — 2-6 chars,\n * uppercase letter first, then letters and digits. Codes are derived\n * conventionally from the name (first-letter-of-each-word for multi-word,\n * first-2-chars for single-word), with non-alpha characters stripped before\n * derivation. Users can override the derived code with explicit\n * `## Name (CODE)` syntax.\n *\n * See ticket 7YN5QB for the full spec.\n */\n\nimport { readFileSync } from 'node:fs';\n\nimport { resolveConfiguredPath } from './configured-paths.js';\nimport { computeSkipMask, stripInlineComments } from './markdown-sections.js';\nimport { findDuplicates, groupByLine } from './validation.js';\n\n// The three constants below are exported for workspace-internal use (tests\n// asserting the canonical bounds, docs referencing them without hardcoding,\n// future code in the same package). They are deliberately NOT re-exported\n// from `src/presets/typescript/index.ts` — customers interact with persona\n// validation through `safeword check`, not by reading these constants\n// directly. Promoting them to safeword's public preset surface would make\n// the values part of safeword's semver contract (changing 6 → 8 would\n// become a breaking change), and there's no current consumer that needs\n// that commitment.\n\n/** Maximum length of a derived short code (overflow is truncated silently). */\nexport const MAX_CODE_LENGTH = 6;\n/** Minimum persona name length — single-char names are rejected at validation. */\nexport const MIN_NAME_LENGTH = 2;\n/** Pattern for a valid persona short code. */\nexport const PERSONA_CODE_PATTERN = /^[A-Z][A-Z0-9]{1,5}$/;\n\n/**\n * Derive a short code from a persona name.\n *\n * Multi-word names use first-letter-of-each-word (\"Platform Operator\" → \"PO\").\n * Single-word names use first-2-chars uppercased (\"Auditor\" → \"AU\").\n * Non-alpha characters (apostrophes, hyphens) are stripped before derivation;\n * digits are preserved within the resulting code.\n * Overflow is truncated to the first {@link MAX_CODE_LENGTH} characters.\n *\n * Note: the returned code may not pass {@link PERSONA_CODE_PATTERN} for\n * pathological inputs (e.g., digit-first names like \"3 Amigos\" → \"3A\").\n * Pattern enforcement happens at validation time, not derivation time.\n */\nexport function derivePersonaCode(name: string): string {\n const trimmed = name.trim();\n if (trimmed.length === 0) return '';\n\n // Strip non-alphanumeric except whitespace — keeps digits, removes\n // apostrophes/hyphens/punctuation. Whitespace remains as the word separator.\n const cleaned = trimmed.replaceAll(/[^A-Z0-9\\s]/gi, '');\n const words = cleaned.split(/\\s+/).filter(word => word.length > 0);\n\n const [firstWord] = words;\n if (!firstWord) return '';\n\n // String.charAt returns '' for empty strings — no narrowing needed and\n // no non-null assertion (each word is non-empty per the filter above,\n // but TypeScript can't prove that on indexed access).\n const derived =\n words.length === 1 ? firstWord.slice(0, 2) : words.map(word => word.charAt(0)).join('');\n\n return derived.toUpperCase().slice(0, MAX_CODE_LENGTH);\n}\n\n/** Whether a persona name passes the minimum-length requirement. */\nexport function isValidPersonaName(name: string): boolean {\n return name.trim().length >= MIN_NAME_LENGTH;\n}\n\n/** Whether a code matches the persona-code pattern. */\nexport function isValidPersonaCode(code: string): boolean {\n return PERSONA_CODE_PATTERN.test(code);\n}\n\n/**\n * A parsed persona block — name, code (possibly empty before resolution),\n * line number of the header (1-indexed), and whether the user explicitly\n * authored the code via `## Name (CODE)` syntax.\n */\nexport interface ParsedPersona {\n name: string;\n /** Empty string when no code was authored (will be filled by {@link resolvePersonaCodes}). */\n rawCode: string;\n /** True when the code came from `## Name (CODE)` syntax; false when absent in source. */\n explicit: boolean;\n /** 1-indexed line number of the `## ` header. */\n lineNumber: number;\n /** Whether a `**Role:**` line was found in the block body. */\n hasRole: boolean;\n}\n\n/** A resolved persona — code is always populated (derived if not explicit). */\nexport interface ResolvedPersona extends ParsedPersona {\n code: string;\n}\n\n/** A validation error with a 1-indexed line reference into the source content. */\nexport interface PersonaValidationError {\n line: number;\n message: string;\n}\n\n/**\n * Extract name and (optional) code from a `## ...` header line.\n *\n * Parsed manually rather than with regex to avoid super-linear-backtracking\n * vulnerabilities flagged by `regexp/no-super-linear-backtracking`. The\n * `(CODE)` suffix is detected by checking for a trailing `)` and locating\n * its matching `(` via `lastIndexOf` — no quantifier overlap. Inline HTML\n * comments are stripped from the body before name/code extraction so a\n * trailing `<!-- ... -->` doesn't corrupt the parsed name.\n */\nfunction parseHeaderLine(line: string): { name: string; rawCode: string | undefined } | undefined {\n if (!line.startsWith('## ')) return undefined;\n const body = stripInlineComments(line.slice(3)).trimEnd();\n if (body.endsWith(')')) {\n const openParen = body.lastIndexOf('(');\n if (openParen !== -1) {\n const namePart = body.slice(0, openParen).trim();\n const codePart = body.slice(openParen + 1, -1).trim();\n return { name: namePart, rawCode: codePart };\n }\n }\n return { name: body.trim(), rawCode: undefined };\n}\n\n/**\n * Parse persona blocks from markdown content.\n *\n * A block starts at a level-2 header (`## ...`) and runs until the next\n * level-2 header or end of file. The header may include a parenthesized\n * code (`## Name (PO)`) or omit it (`## Name`). The body is scanned for\n * a `**Role:**` line; presence is recorded but the role text isn't\n * extracted here (validation only needs the existence check).\n *\n * Pure — no I/O.\n */\nexport function parsePersonas(content: string): ParsedPersona[] {\n const lines = content.split('\\n');\n const skip = computeSkipMask(lines);\n const personas: ParsedPersona[] = [];\n let current: ParsedPersona | undefined;\n\n for (const [index, line] of lines.entries()) {\n if (skip[index]) continue;\n const header = parseHeaderLine(line);\n if (header) {\n if (current) personas.push(current);\n current = {\n name: header.name,\n rawCode: header.rawCode ?? '',\n explicit: header.rawCode !== undefined,\n lineNumber: index + 1,\n hasRole: false,\n };\n continue;\n }\n if (current && line.startsWith('**Role:**')) {\n current.hasRole = true;\n }\n }\n\n if (current) personas.push(current);\n return personas;\n}\n\n/**\n * Resolve auto-derived codes with collision avoidance.\n *\n * For each persona without an explicit code, derive one from the name.\n * If the derived code is already taken (by a user-authored explicit code\n * or a previously-resolved derivation in the same pass), append a numeric\n * suffix starting at 2 (`PO` → `PO2` → `PO3` → ...).\n *\n * Explicit codes are claimed up-front so derived codes always lose\n * collision disputes against user-authored ones.\n */\nexport function resolvePersonaCodes(parsed: readonly ParsedPersona[]): ResolvedPersona[] {\n const claimed = new Set<string>();\n for (const persona of parsed) {\n if (persona.explicit && persona.rawCode.length > 0) {\n claimed.add(persona.rawCode);\n }\n }\n\n const resolved: ResolvedPersona[] = [];\n for (const persona of parsed) {\n if (persona.explicit) {\n resolved.push({ ...persona, code: persona.rawCode });\n continue;\n }\n const base = derivePersonaCode(persona.name);\n let candidate = base;\n let suffix = 2;\n while (claimed.has(candidate)) {\n candidate = `${base}${suffix}`;\n suffix += 1;\n }\n claimed.add(candidate);\n resolved.push({ ...persona, code: candidate });\n }\n\n return resolved;\n}\n\n/**\n * Validate parsed personas. Returns a list of {@link PersonaValidationError}\n * with 1-indexed line numbers; empty list means the file is well-formed.\n *\n * Checks (each independent):\n * - Persona name is ≥ {@link MIN_NAME_LENGTH} characters\n * - Header has a name (not just `## (CODE)`)\n * - Block has a `**Role:**` line\n * - Persona names are unique within the file\n * - Resolved codes are unique within the file\n * - Resolved codes match {@link PERSONA_CODE_PATTERN}\n * (digit-first names like \"3 Amigos\" derive non-conformant codes and\n * surface here with the explicit-override prompt)\n */\nfunction validateNameAndRole(persona: ParsedPersona): PersonaValidationError[] {\n const errors: PersonaValidationError[] = [];\n if (persona.name.length === 0) {\n errors.push({ line: persona.lineNumber, message: 'missing persona name' });\n } else if (!isValidPersonaName(persona.name)) {\n errors.push({\n line: persona.lineNumber,\n message: 'persona name must be at least 2 characters',\n });\n }\n if (!persona.hasRole) {\n errors.push({ line: persona.lineNumber, message: 'missing Role line' });\n }\n return errors;\n}\n\n/** Produce pattern-violation errors for resolved personas. */\nfunction findPatternErrors(resolved: readonly ResolvedPersona[]): PersonaValidationError[] {\n const errors: PersonaValidationError[] = [];\n for (const persona of resolved) {\n if (persona.code.length === 0) continue;\n if (isValidPersonaCode(persona.code)) continue;\n const message = persona.explicit\n ? `code \"${persona.code}\" violates pattern ${PERSONA_CODE_PATTERN.source}`\n : `name produces non-conformant code \"${persona.code}\" — author explicit code via \\`## Name (CODE)\\``;\n errors.push({ line: persona.lineNumber, message });\n }\n return errors;\n}\n\nexport function validatePersonas(parsed: readonly ParsedPersona[]): PersonaValidationError[] {\n const resolved = resolvePersonaCodes(parsed);\n return [\n ...parsed.flatMap(persona => validateNameAndRole(persona)),\n ...findDuplicates(\n groupByLine(parsed, persona => persona.name),\n 'persona name',\n ),\n ...findPatternErrors(resolved),\n ...findDuplicates(\n groupByLine(resolved, persona => persona.code),\n 'persona code',\n ),\n ];\n}\n\n/**\n * Result of resolving a persona reference against the file.\n *\n * Discriminated union — `match` is guaranteed when `status === 'valid'`;\n * `suggestion` is only meaningful (and only ever populated) when\n * `status === 'unknown'`. Callers can narrow without optional chaining\n * after checking `status`.\n */\nexport type PersonaReferenceResult =\n | { status: 'valid'; match: ResolvedPersona }\n | { status: 'unknown'; suggestion?: string };\n\n/**\n * Look up a persona reference against a parsed-and-resolved list.\n *\n * Strict on casing: `\"po\"` against existing `PO` returns\n * `{ status: 'unknown', suggestion: 'PO' }`. Lenient matching would\n * silently alias persona codes that legitimately differ by case\n * (`PO` vs `Po` vs `PO2`).\n *\n * Match priority: exact code → exact name → casing-mismatch suggestion.\n *\n * Pure — no I/O. Wrap with {@link validatePersonaReference} for the file-reading\n * path.\n */\nexport function lookupPersonaReference(\n personas: readonly ResolvedPersona[],\n input: string,\n): PersonaReferenceResult {\n if (input.length === 0) return { status: 'unknown' };\n\n for (const persona of personas) {\n if (persona.code === input || persona.name === input) {\n return { status: 'valid', match: persona };\n }\n }\n\n // Casing-mismatch detection — search again with lowercase comparison.\n const lowered = input.toLowerCase();\n for (const persona of personas) {\n if (persona.code.toLowerCase() === lowered) {\n return { status: 'unknown', suggestion: persona.code };\n }\n if (persona.name.toLowerCase() === lowered) {\n return { status: 'unknown', suggestion: persona.name };\n }\n }\n\n return { status: 'unknown' };\n}\n\n/**\n * Resolve a persona reference against the on-disk personas file.\n *\n * Reads from `paths.personas` in `.safeword/config.json` when configured;\n * falls back to the namespace-root default otherwise. Degrades\n * gracefully on a missing or unreadable file — returns\n * `{ status: 'unknown' }` rather than throwing, regardless of whether the\n * resolved path is the default or a configured override. Strict\n * validation lives in `safeword check`; this lookup API is meant to be\n * cheap, consistent, and side-effect-free. Do NOT change the unknown\n * return to a throw for configured-but-missing — `safeword check` owns\n * the loud signal (ticket K7N2QM).\n */\nexport function validatePersonaReference(cwd: string, input: string): PersonaReferenceResult {\n let content: string;\n try {\n const filePath = resolveConfiguredPath(cwd, 'personas');\n content = readFileSync(filePath, 'utf8');\n } catch {\n return { status: 'unknown' };\n }\n const personas = resolvePersonaCodes(parsePersonas(content));\n return lookupPersonaReference(personas, input);\n}\n"],"mappings":"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","names":["readdirSync","nodePath","readFileSync","header","nodePath","readdirSync"]}
@@ -0,0 +1,65 @@
1
+ import {
2
+ isDirectory,
3
+ readFileSafe
4
+ } from "./chunk-445LAX4Y.js";
5
+
6
+ // src/utils/configured-paths.ts
7
+ import nodePath from "path";
8
+ var CONFIG_SUBPATH = [".safeword", "config.json"];
9
+ var NAMESPACE_ROOT_DEFAULT = ".project";
10
+ var NAMESPACE_ROOT_LEGACY = ".safeword-project";
11
+ function readConfiguredPath(cwd, key) {
12
+ const configPath = nodePath.join(cwd, ...CONFIG_SUBPATH);
13
+ const content = readFileSafe(configPath);
14
+ if (content === void 0) return void 0;
15
+ let parsed;
16
+ try {
17
+ parsed = JSON.parse(content);
18
+ } catch {
19
+ return void 0;
20
+ }
21
+ const raw = parsed.paths?.[key];
22
+ if (typeof raw !== "string" || raw.length === 0) return void 0;
23
+ return raw;
24
+ }
25
+ function resolveNamespaceRoot(cwd) {
26
+ const configured = readConfiguredPath(cwd, "projectRoot");
27
+ if (configured !== void 0) {
28
+ return nodePath.isAbsolute(configured) ? configured : nodePath.join(cwd, configured);
29
+ }
30
+ const defaultRoot = nodePath.join(cwd, NAMESPACE_ROOT_DEFAULT);
31
+ if (isDirectory(defaultRoot)) return defaultRoot;
32
+ const legacyRoot = nodePath.join(cwd, NAMESPACE_ROOT_LEGACY);
33
+ if (isDirectory(legacyRoot)) return legacyRoot;
34
+ return defaultRoot;
35
+ }
36
+ function resolveTicketsDirectory(cwd) {
37
+ return nodePath.join(resolveNamespaceRoot(cwd), "tickets");
38
+ }
39
+ function resolveLearningsDirectory(cwd) {
40
+ return nodePath.join(resolveNamespaceRoot(cwd), "learnings");
41
+ }
42
+ function defaultConfiguredPath(cwd, key) {
43
+ return nodePath.join(resolveNamespaceRoot(cwd), `${key}.md`);
44
+ }
45
+ function resolveConfiguredPath(cwd, key) {
46
+ const override = readConfiguredPath(cwd, key);
47
+ if (override === void 0) {
48
+ return defaultConfiguredPath(cwd, key);
49
+ }
50
+ if (nodePath.isAbsolute(override)) {
51
+ return override;
52
+ }
53
+ return nodePath.join(cwd, override);
54
+ }
55
+
56
+ export {
57
+ NAMESPACE_ROOT_LEGACY,
58
+ readConfiguredPath,
59
+ resolveNamespaceRoot,
60
+ resolveTicketsDirectory,
61
+ resolveLearningsDirectory,
62
+ defaultConfiguredPath,
63
+ resolveConfiguredPath
64
+ };
65
+ //# sourceMappingURL=chunk-3BMVTFFM.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils/configured-paths.ts"],"sourcesContent":["/**\n * Resolves user-configurable read targets (personas, glossary, architecture).\n *\n * Reads `.safeword/config.json` for an optional `paths` object — each key\n * maps to a file path the user wants safeword to read instead of the\n * default `<namespace-root>/<key>.md` location (see resolveNamespaceRoot).\n *\n * Path resolution:\n * - Relative paths resolve against project root (the directory containing\n * `.safeword/config.json`, which equals `cwd` in current invocations).\n * - Absolute paths are used verbatim.\n * - Empty-string or non-string values are treated as unset (defensive).\n *\n * See ticket K7N2QM for the design rationale, including why this is not a\n * cosmiconfig-style discovery layer and why N=3 doesn't warrant a\n * logical-filesystem abstraction.\n */\n\nimport nodePath from 'node:path';\n\nimport { isDirectory, readFileSafe } from './fs.js';\n\n/** Logical keys safeword knows how to override via `paths.*`. */\nexport type ConfiguredPathKey = 'personas' | 'glossary' | 'architecture';\n\ninterface SafewordConfigShape {\n paths?: Partial<Record<ConfiguredPathKey | 'projectRoot', unknown>>;\n}\n\nconst CONFIG_SUBPATH = ['.safeword', 'config.json'];\n\n/** Default namespace root for fresh contexts (epic AQJ95G). */\nconst NAMESPACE_ROOT_DEFAULT = '.project';\n\n/** Legacy namespace root, honored where it already exists (pre-AQJ95G installs). */\nexport const NAMESPACE_ROOT_LEGACY = '.safeword-project';\n\n/**\n * Read the override path for `key` from `.safeword/config.json`, if any.\n * Returns the raw override string (unresolved) or `undefined` when unset,\n * empty, non-string, or the config file is missing/unparseable.\n *\n * Exported for callers that need to know \"is this overridden?\" without\n * resolving the path (e.g., reconcile's `configKey` gate, `safeword check`\n * advisory messaging).\n */\nexport function readConfiguredPath(\n cwd: string,\n key: ConfiguredPathKey | 'projectRoot',\n): string | undefined {\n const configPath = nodePath.join(cwd, ...CONFIG_SUBPATH);\n const content = readFileSafe(configPath);\n if (content === undefined) return undefined;\n\n let parsed: SafewordConfigShape;\n try {\n parsed = JSON.parse(content) as SafewordConfigShape;\n } catch {\n return undefined;\n }\n\n const raw = parsed.paths?.[key];\n if (typeof raw !== 'string' || raw.length === 0) return undefined;\n return raw;\n}\n\n/**\n * Resolve the absolute namespace root — the directory holding safeword's\n * project knowledge (tickets, learnings, personas, glossary, architecture).\n *\n * Precedence (epic AQJ95G): explicit config `paths.projectRoot` →\n * `.project/` (the default, shared with arcade) → legacy `.safeword-project/`\n * where one already exists. A project with neither directory resolves to\n * `.project/` so fresh contexts land on the current convention.\n */\nexport function resolveNamespaceRoot(cwd: string): string {\n const configured = readConfiguredPath(cwd, 'projectRoot');\n if (configured !== undefined) {\n return nodePath.isAbsolute(configured) ? configured : nodePath.join(cwd, configured);\n }\n\n const defaultRoot = nodePath.join(cwd, NAMESPACE_ROOT_DEFAULT);\n if (isDirectory(defaultRoot)) return defaultRoot;\n\n const legacyRoot = nodePath.join(cwd, NAMESPACE_ROOT_LEGACY);\n if (isDirectory(legacyRoot)) return legacyRoot;\n\n return defaultRoot;\n}\n\n/** Absolute tickets directory under the resolved namespace root. */\nexport function resolveTicketsDirectory(cwd: string): string {\n return nodePath.join(resolveNamespaceRoot(cwd), 'tickets');\n}\n\n/** Absolute learnings directory under the resolved namespace root. */\nexport function resolveLearningsDirectory(cwd: string): string {\n return nodePath.join(resolveNamespaceRoot(cwd), 'learnings');\n}\n\n/**\n * The default (non-overridden) absolute location of a configurable read\n * target: `<resolveNamespaceRoot(cwd)>/<key>.md`.\n */\nexport function defaultConfiguredPath(cwd: string, key: ConfiguredPathKey): string {\n return nodePath.join(resolveNamespaceRoot(cwd), `${key}.md`);\n}\n\n/**\n * Resolve the absolute filesystem path for a configurable read target.\n *\n * Without a per-file override, the default derives from the resolved\n * namespace root (see {@link defaultConfiguredPath}).\n *\n * @param cwd - Project root directory.\n * @param key - Logical key (`personas` | `glossary` | `architecture`).\n */\nexport function resolveConfiguredPath(cwd: string, key: ConfiguredPathKey): string {\n const override = readConfiguredPath(cwd, key);\n if (override === undefined) {\n return defaultConfiguredPath(cwd, key);\n }\n if (nodePath.isAbsolute(override)) {\n return override;\n }\n return nodePath.join(cwd, override);\n}\n"],"mappings":";;;;;;AAkBA,OAAO,cAAc;AAWrB,IAAM,iBAAiB,CAAC,aAAa,aAAa;AAGlD,IAAM,yBAAyB;AAGxB,IAAM,wBAAwB;AAW9B,SAAS,mBACd,KACA,KACoB;AACpB,QAAM,aAAa,SAAS,KAAK,KAAK,GAAG,cAAc;AACvD,QAAM,UAAU,aAAa,UAAU;AACvC,MAAI,YAAY,OAAW,QAAO;AAElC,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,OAAO;AAAA,EAC7B,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,OAAO,QAAQ,GAAG;AAC9B,MAAI,OAAO,QAAQ,YAAY,IAAI,WAAW,EAAG,QAAO;AACxD,SAAO;AACT;AAWO,SAAS,qBAAqB,KAAqB;AACxD,QAAM,aAAa,mBAAmB,KAAK,aAAa;AACxD,MAAI,eAAe,QAAW;AAC5B,WAAO,SAAS,WAAW,UAAU,IAAI,aAAa,SAAS,KAAK,KAAK,UAAU;AAAA,EACrF;AAEA,QAAM,cAAc,SAAS,KAAK,KAAK,sBAAsB;AAC7D,MAAI,YAAY,WAAW,EAAG,QAAO;AAErC,QAAM,aAAa,SAAS,KAAK,KAAK,qBAAqB;AAC3D,MAAI,YAAY,UAAU,EAAG,QAAO;AAEpC,SAAO;AACT;AAGO,SAAS,wBAAwB,KAAqB;AAC3D,SAAO,SAAS,KAAK,qBAAqB,GAAG,GAAG,SAAS;AAC3D;AAGO,SAAS,0BAA0B,KAAqB;AAC7D,SAAO,SAAS,KAAK,qBAAqB,GAAG,GAAG,WAAW;AAC7D;AAMO,SAAS,sBAAsB,KAAa,KAAgC;AACjF,SAAO,SAAS,KAAK,qBAAqB,GAAG,GAAG,GAAG,GAAG,KAAK;AAC7D;AAWO,SAAS,sBAAsB,KAAa,KAAgC;AACjF,QAAM,WAAW,mBAAmB,KAAK,GAAG;AAC5C,MAAI,aAAa,QAAW;AAC1B,WAAO,sBAAsB,KAAK,GAAG;AAAA,EACvC;AACA,MAAI,SAAS,WAAW,QAAQ,GAAG;AACjC,WAAO;AAAA,EACT;AACA,SAAO,SAAS,KAAK,KAAK,QAAQ;AACpC;","names":[]}
@@ -7,6 +7,7 @@ import {
7
7
  readFileSync,
8
8
  rmdirSync,
9
9
  rmSync,
10
+ statSync,
10
11
  writeFileSync
11
12
  } from "fs";
12
13
  import nodePath from "path";
@@ -28,6 +29,13 @@ function getTemplatesDirectory() {
28
29
  }
29
30
  throw new Error("Templates directory not found");
30
31
  }
32
+ function isDirectory(path) {
33
+ try {
34
+ return statSync(path).isDirectory();
35
+ } catch {
36
+ return false;
37
+ }
38
+ }
31
39
  function exists(path) {
32
40
  return existsSync(path);
33
41
  }
@@ -133,8 +141,38 @@ function writeJson(path, data) {
133
141
  `);
134
142
  }
135
143
 
144
+ // src/utils/output.ts
145
+ function info(message) {
146
+ console.log(message);
147
+ }
148
+ function formatGlyphLine(glyph, message) {
149
+ const leadingNewlines = /^\n*/.exec(message)?.[0] ?? "";
150
+ return `${leadingNewlines}${glyph} ${message.slice(leadingNewlines.length)}`;
151
+ }
152
+ function success(message) {
153
+ console.log(formatGlyphLine("\u2713", message));
154
+ }
155
+ function warn(message) {
156
+ console.warn(formatGlyphLine("\u26A0", message));
157
+ }
158
+ function error(message) {
159
+ console.error(formatGlyphLine("\u2717", message));
160
+ }
161
+ function header(title) {
162
+ console.log(`
163
+ ${title}`);
164
+ console.log("\u2500".repeat(title.length));
165
+ }
166
+ function listItem(item, indent = 2) {
167
+ console.log(`${" ".repeat(indent)}\u2022 ${item}`);
168
+ }
169
+ function keyValue(key, value) {
170
+ console.log(` ${key}: ${value}`);
171
+ }
172
+
136
173
  export {
137
174
  getTemplatesDirectory,
175
+ isDirectory,
138
176
  exists,
139
177
  existsInTree,
140
178
  findInTree,
@@ -146,6 +184,13 @@ export {
146
184
  removeIfEmpty,
147
185
  makeScriptsExecutable,
148
186
  readJson,
149
- writeJson
187
+ writeJson,
188
+ info,
189
+ success,
190
+ warn,
191
+ error,
192
+ header,
193
+ listItem,
194
+ keyValue
150
195
  };
151
- //# sourceMappingURL=chunk-QARISSCT.js.map
196
+ //# sourceMappingURL=chunk-445LAX4Y.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils/fs.ts","../src/utils/output.ts"],"sourcesContent":["/**\n * File system utilities for CLI operations\n */\n\nimport {\n chmodSync,\n existsSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmdirSync,\n rmSync,\n statSync,\n writeFileSync,\n} from 'node:fs';\nimport nodePath from 'node:path';\n\n// Get the directory of this module (for locating templates)\nconst __dirname = import.meta.dirname;\n\n/**\n * Get path to bundled templates directory.\n * Works in both development (src/) and production (dist/) contexts.\n *\n * Note: We check for SAFEWORD.md to distinguish from src/templates/ which\n * contains TypeScript source files (config.ts, content.ts).\n *\n * Path resolution (bundled with tsup):\n * - From dist/chunk-*.js: __dirname = packages/cli/dist/ → ../templates\n */\nexport function getTemplatesDirectory(): string {\n const knownTemplateFile = 'SAFEWORD.md';\n\n // Try different relative paths - the bundled code ends up in dist/ directly (flat)\n // while source is in src/utils/\n const candidates = [\n nodePath.join(__dirname, '..', 'templates'), // From dist/ (flat bundled)\n nodePath.join(__dirname, '..', '..', 'templates'), // From src/utils/ or dist/utils/\n nodePath.join(__dirname, 'templates'), // Direct sibling (unlikely but safe)\n ];\n\n for (const candidate of candidates) {\n if (existsSync(nodePath.join(candidate, knownTemplateFile))) {\n return candidate;\n }\n }\n\n throw new Error('Templates directory not found');\n}\n\n/**\n * Check if a path exists\n * @param path\n */\n/** True when `path` exists and is a directory (a file is not). */\nexport function isDirectory(path: string): boolean {\n try {\n return statSync(path).isDirectory();\n } catch {\n return false;\n }\n}\n\nexport function exists(path: string): boolean {\n return existsSync(path);\n}\n\n/**\n * Directories to exclude when scanning subdirectories for language manifests.\n * These contain vendored/generated files that would cause false positives.\n */\nconst SUBDIRECTORY_EXCLUDE = new Set([\n 'node_modules',\n '.git',\n '.safeword',\n 'vendor',\n 'dist',\n 'build',\n 'target',\n 'coverage',\n 'dbt_packages',\n 'out',\n '.next',\n '.nuxt',\n '.output',\n '__pycache__',\n '.venv',\n 'venv',\n]);\n\n/**\n * Check if a file exists anywhere in the project tree.\n * Recursively scans subdirectories, skipping excluded directories.\n *\n * @param cwd - Project root directory\n * @param filename - File to search for (e.g., 'pyproject.toml')\n * @returns true if found anywhere in the project tree\n */\nexport function existsInTree(cwd: string, filename: string): boolean {\n return findInTree(cwd, filename) !== undefined;\n}\n\n/**\n * Find a file anywhere in the project tree.\n * Recursively scans subdirectories, skipping excluded directories.\n * Root is checked first; deeper matches use depth-first traversal.\n *\n * @param cwd - Project root directory\n * @param filename - File to search for (e.g., 'pyproject.toml')\n * @param maxDepth - Maximum directory depth to scan (default: 10)\n * @returns Directory path where file was found, or undefined\n */\nexport function findInTree(cwd: string, filename: string, maxDepth = 10): string | undefined {\n // Check root first\n if (existsSync(nodePath.join(cwd, filename))) {\n return cwd;\n }\n\n return scanTreeForFile(cwd, filename, 1, maxDepth);\n}\n\n/** Return scannable subdirectory paths (excludes hidden dirs and SUBDIRECTORY_EXCLUDE). */\nfunction getScannableSubdirectories(directory: string): string[] {\n try {\n return readdirSync(directory, { withFileTypes: true })\n .filter(\n entry =>\n entry.isDirectory() &&\n !entry.name.startsWith('.') &&\n !SUBDIRECTORY_EXCLUDE.has(entry.name),\n )\n .map(entry => nodePath.join(directory, entry.name));\n } catch {\n return [];\n }\n}\n\nfunction scanTreeForFile(\n directory: string,\n filename: string,\n depth: number,\n maxDepth: number,\n): string | undefined {\n if (depth > maxDepth) return undefined;\n\n const subdirectories = getScannableSubdirectories(directory);\n\n // Check all children at this level first\n for (const subdirectory of subdirectories) {\n if (existsSync(nodePath.join(subdirectory, filename))) {\n return subdirectory;\n }\n }\n\n // Then recurse deeper\n for (const subdirectory of subdirectories) {\n const result = scanTreeForFile(subdirectory, filename, depth + 1, maxDepth);\n if (result !== undefined) return result;\n }\n\n return undefined;\n}\n\n/**\n * Create directory recursively\n * @param path\n */\nexport function ensureDirectory(path: string): void {\n if (!existsSync(path)) {\n mkdirSync(path, { recursive: true });\n }\n}\n\n/**\n * Read file as string\n * @param path\n */\nexport function readFile(path: string): string {\n return readFileSync(path, 'utf8');\n}\n\n/**\n * Read file as string, return null if not exists\n * @param path\n */\nexport function readFileSafe(path: string): string | undefined {\n if (!existsSync(path)) return undefined;\n return readFileSync(path, 'utf8');\n}\n\n/**\n * Write file, creating parent directories if needed\n * @param path\n * @param content\n */\nexport function writeFile(path: string, content: string): void {\n ensureDirectory(nodePath.dirname(path));\n writeFileSync(path, content);\n}\n\n/**\n * Remove file or directory recursively\n * @param path\n */\nexport function remove(path: string): void {\n if (existsSync(path)) {\n rmSync(path, { recursive: true, force: true });\n }\n}\n\n/**\n * Remove directory only if empty, returns true if removed\n * @param path\n */\nexport function removeIfEmpty(path: string): boolean {\n if (!existsSync(path)) return false;\n try {\n rmdirSync(path); // Non-recursive, throws if not empty\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Make all shell scripts in a directory executable\n * @param dirPath\n */\nexport function makeScriptsExecutable(dirPath: string): void {\n if (!existsSync(dirPath)) return;\n for (const file of readdirSync(dirPath)) {\n if (file.endsWith('.sh')) {\n chmodSync(nodePath.join(dirPath, file), 0o755);\n }\n }\n}\n\n/**\n * Read JSON file\n * @param path\n */\nexport function readJson(path: string): unknown {\n const content = readFileSafe(path);\n if (!content) return undefined;\n try {\n return JSON.parse(content) as unknown;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Write JSON file with formatting\n * @param path\n * @param data\n */\nexport function writeJson(path: string, data: unknown): void {\n writeFile(path, `${JSON.stringify(data, undefined, 2)}\\n`);\n}\n","/**\n * Console output utilities for consistent CLI messaging\n */\n\n/**\n * Print info message\n * @param message\n */\nexport function info(message: string): void {\n console.log(message);\n}\n\n/**\n * Compose a glyph-prefixed line, hoisting any leading newlines ABOVE the glyph\n * so blank-line spacing renders before the marker instead of orphaning it on\n * its own line (ticket 469YSR). `('✓', '\\nFoo')` → `'\\n✓ Foo'`.\n * @param glyph the status glyph (✓ / ⚠ / ✗)\n * @param message the message, which may start with newline(s) for spacing\n */\nexport function formatGlyphLine(glyph: string, message: string): string {\n const leadingNewlines = /^\\n*/.exec(message)?.[0] ?? '';\n return `${leadingNewlines}${glyph} ${message.slice(leadingNewlines.length)}`;\n}\n\n/**\n * Print success message\n * @param message\n */\nexport function success(message: string): void {\n console.log(formatGlyphLine('✓', message));\n}\n\n/**\n * Print warning message\n * @param message\n */\nexport function warn(message: string): void {\n console.warn(formatGlyphLine('⚠', message));\n}\n\n/**\n * Print error message to stderr\n * @param message\n */\nexport function error(message: string): void {\n console.error(formatGlyphLine('✗', message));\n}\n\n/**\n * Print a section header\n * @param title\n */\nexport function header(title: string): void {\n console.log(`\\n${title}`);\n console.log('─'.repeat(title.length));\n}\n\n/**\n * Print a list item\n * @param item\n * @param indent\n */\nexport function listItem(item: string, indent = 2): void {\n console.log(`${' '.repeat(indent)}• ${item}`);\n}\n\n/**\n * Print key-value pair\n * @param key\n * @param value\n */\nexport function keyValue(key: string, value: string): void {\n console.log(` ${key}: ${value}`);\n}\n"],"mappings":"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","names":[]}