@phuc1403/musketeer 0.4.0 → 0.6.0

package/template/.claude/skills/architecture-characteristic-writer/scripts/ranking-table.cjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+// Scaffolds and repairs the architecture-characteristics ranking table.
+//
+//   scaffold  write a blank ranking holding every catalog characteristic
+//   fix       renumber the Order column and rebuild every "Above X:" prefix
+//             from the row order as it now stands, keeping the justifications
+//
+// Ranking ORDER and justification prose are the architect's work. Everything
+// this script touches — which characteristics appear, the numbering, which row
+// each reason compares against — is mechanical, so no one has to transcribe it.
+//
+// Run `fix` after moving rows. A prefix left naming the wrong row is the usual
+// defect after a reorder, and regenerating them makes it impossible.
+
+const fs = require('fs');
+const path = require('path');
+
+const {
+  loadCatalog,
+  normalise,
+  locateTable,
+  splitCells,
+  isSeparator,
+  RANKING_HEADER,
+} = require('../../../hooks/lib/characteristics/checker.cjs');
+
+const DEFAULT_FILE = 'docs/architecture-characteristics-ranking.md';
+
+// The validation hook resolves the ranking against CLAUDE_PROJECT_DIR. Resolve
+// against the same root, or running this from a subdirectory would quietly
+// write a second ranking somewhere the hook never looks at.
+const projectRoot = () => process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const PLACEHOLDER = '{why}';
+const HEADING = '# Architecture Characteristics Ranking';
+
+const PREAMBLE = [
+  HEADING,
+  '',
+  'All characteristics in priority order. The top 7 feed the worksheet in',
+  '`architecture-characteristics.md`.',
+  '',
+  '<!-- Reason = why this row outranks the row directly BELOW it. Comparative, never a description.',
+  '     Keep the "Above {next characteristic}:" prefix and replace {why} with the justification.',
+  '     Both sides must appear: what this row protects, and what the row below gives up.',
+  '     State WHY the system needs it, meaning the business driver or risk.',
+  '     Never name the mechanism: no patterns, libraries, components, or tactics.',
+  '',
+  '     Move rows freely, then run scripts/ranking-table.cjs fix to renumber and',
+  '     rebuild every prefix. Do not hand-maintain the numbering or the prefixes. -->',
+  '',
+];
+
+const die = (msg) => {
+  process.stderr.write(`${msg}\n`);
+  process.exit(1);
+};
+
+// Builds the three table lines plus data rows for the given ordered names,
+// pairing each row with the justification supplied for it.
+function render(order, justifications) {
+  const rows = order.map((name, i) => {
+    const last = i === order.length - 1;
+    const reason = last ? '—' : `Above ${order[i + 1]}: ${justifications[i] || PLACEHOLDER}`;
+    return `| ${i + 1} | ${name} | ${reason} |`;
+  });
+  return ['| Order | Characteristic | Reason |', '|---|---|---|', ...rows];
+}
+
+// Drops an "Above X:" prefix and a lone em dash, leaving the justification the
+// author actually wrote.
+function justificationOf(reason) {
+  const text = String(reason).trim();
+  if (/^[—-]$/.test(text)) return '';
+  const m = text.match(/^above\s+[^:]+:\s*(.*)$/i);
+  return (m ? m[1] : text).trim();
+}
+
+function scaffold(argv) {
+  const out = argv.out || DEFAULT_FILE;
+  const target = path.resolve(projectRoot(), out);
+
+  if (fs.existsSync(target) && !argv.force) {
+    die(`${out} already exists. Run fix to repair it, or pass --force to start over.`);
+  }
+
+  const { catalog } = loadCatalog(argv.catalog);
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(target, [...PREAMBLE, ...render(catalog, []), ''].join('\n'), 'utf8');
+
+  process.stdout.write(
+    `Wrote ${out} with ${catalog.length} characteristics in catalog order.\n` +
+      'Reorder the rows, replace every {why}, then run fix.\n'
+  );
+}
+
+function fix(argv) {
+  const file = argv.file || DEFAULT_FILE;
+  const target = path.resolve(projectRoot(), file);
+
+  if (!fs.existsSync(target)) die(`${file} does not exist. Run scaffold first.`);
+
+  const original = fs.readFileSync(target, 'utf8');
+  const eol = original.includes('\r\n') ? '\r\n' : '\n';
+  const lines = original.split(/\r?\n/);
+
+  const bounds = locateTable(lines, RANKING_HEADER);
+  if (!bounds) die(`${file} holds no table with a "| Order | Characteristic | Reason |" header row.`);
+
+  const table = lines.slice(bounds.start, bounds.end);
+  const data = table.filter((l) => {
+    const c = splitCells(l);
+    return c.length >= 3 && !isSeparator(c) && !/^order$/i.test(c[0]);
+  });
+
+  if (!data.length) die(`${file} holds no ranking rows to fix.`);
+
+  const order = data.map((l) => normalise(splitCells(l)[1]));
+  const justifications = data.map((l) => justificationOf(splitCells(l)[2]));
+
+  const { catalog } = loadCatalog(argv.catalog);
+  const unknown = order.filter((n) => !catalog.includes(n));
+  if (unknown.length) die(`${file} names characteristics absent from the catalog: ${unknown.join(', ')}`);
+
+  const rebuilt = render(order, justifications);
+  const next = [...lines.slice(0, bounds.start), ...rebuilt, ...lines.slice(bounds.end)];
+  const updated = next.join(eol);
+
+  // Reported whether or not anything moved: a scaffold is already correct and
+  // still has every justification left to write.
+  const blank = justifications.filter((j, i) => i < justifications.length - 1 && (!j || j === PLACEHOLDER)).length;
+  const outstanding = blank ? `${blank} row(s) still need a justification in place of ${PLACEHOLDER}.\n` : '';
+
+  if (updated === original) {
+    process.stdout.write(`${file} is already correct.\n${outstanding}`);
+    return;
+  }
+
+  fs.writeFileSync(target, updated, 'utf8');
+
+  const repaired = data.filter((l, i) => splitCells(l)[2] !== splitCells(rebuilt[i + 2])[2]).length;
+  const renumbered = data.filter((l, i) => splitCells(l)[0] !== String(i + 1)).length;
+
+  process.stdout.write(
+    `Fixed ${file}: renumbered ${renumbered} row(s), rebuilt ${repaired} reason(s).\n${outstanding}`
+  );
+}
+
+function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  const argv = { force: false };
+
+  for (let i = 0; i < rest.length; i += 1) {
+    const flag = rest[i];
+    if (flag === '--force') argv.force = true;
+    else if (flag === '--out') argv.out = rest[(i += 1)];
+    else if (flag === '--file') argv.file = rest[(i += 1)];
+    else if (flag === '--catalog') argv.catalog = rest[(i += 1)];
+    else die(`unknown argument: ${flag}`);
+  }
+
+  try {
+    if (command === 'scaffold') return scaffold(argv);
+    if (command === 'fix') return fix(argv);
+  } catch (err) {
+    die(err.message);
+  }
+
+  die('usage: ranking-table.cjs scaffold [--out <path>] [--force] | fix [--file <path>]');
+}
+
+main();

package/template/dotnet-scaffold/src/__SolutionName__.Api/obj/Debug/net10.0/__SolutionName__.Api.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Api")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Api")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Api")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/src/__SolutionName__.Api/obj/Debug/net10.0/__SolutionName__.Api.AssemblyInfoInputs.cache

@@ -1 +1 @@
-d837ad0b9eac655ab38ab4bc05ad8a8eb7b84758bca71acbc2c0eb411a5d092d
+4298d8a040ee36c6ecb7c12883cbdc1381c7f7abfe52e4eb6c9292c35d1cfb06

package/template/dotnet-scaffold/src/__SolutionName__.Application/obj/Debug/net10.0/__SolutionName__.Application.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Application")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Application")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Application")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/src/__SolutionName__.Application/obj/Debug/net10.0/__SolutionName__.Application.AssemblyInfoInputs.cache

@@ -1 +1 @@
-b2a7e660b0aec34f2b56ff0f06b59027837a8c27d54f86c080961356183283d5
+2858fe6c560a4383868ed18aead8a02110a0c12921a1b85eb8ab064e413819cc

package/template/dotnet-scaffold/src/__SolutionName__.Domain/obj/Debug/net10.0/__SolutionName__.Domain.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Domain")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Domain")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Domain")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/src/__SolutionName__.Domain/obj/Debug/net10.0/__SolutionName__.Domain.AssemblyInfoInputs.cache

@@ -1 +1 @@
-71f109e1b935f313e17e4cf82aaedf1f76cfbe0031744a6202cd00a7835efbc3
+429d4931ac2f73372c96b6ad92f5296a812f4266472e3f1700b41d7ff3f16f41

package/template/dotnet-scaffold/src/__SolutionName__.Infrastructure/obj/Debug/net10.0/__SolutionName__.Infrastructure.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Infrastructure")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Infrastructure")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Infrastructure")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/src/__SolutionName__.Infrastructure/obj/Debug/net10.0/__SolutionName__.Infrastructure.AssemblyInfoInputs.cache

@@ -1 +1 @@
-c560d1a7e2db2e251bd7b7c1a5917871be71c539f10c34df844db2e2323beba7
+efbdd4614b485271e16ce1ca7ad96622df5383e04e0fa32fbbdd4a1558d20291

package/template/dotnet-scaffold/tests/__SolutionName__.Api.Tests/obj/Debug/net10.0/__SolutionName__.Api.Tests.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Api.Tests")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Api.Tests")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Api.Tests")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/tests/__SolutionName__.Api.Tests/obj/Debug/net10.0/__SolutionName__.Api.Tests.AssemblyInfoInputs.cache

@@ -1 +1 @@
-9176124e1f73d4336130b279a3d727dd9d5905a345acaa3d4f4cd459ec4e51f5
+92457f55822f171c7b3da491e4d5178c90067407c26c65adf10581c3c6ac96b7

package/template/dotnet-scaffold/tests/__SolutionName__.Application.Tests/obj/Debug/net10.0/__SolutionName__.Application.Tests.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Application.Tests")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Application.Tests")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Application.Tests")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/tests/__SolutionName__.Application.Tests/obj/Debug/net10.0/__SolutionName__.Application.Tests.AssemblyInfoInputs.cache

@@ -1 +1 @@
-0fac6ff00b63553c31f9f27865066066d71fb4cf6516af734a3e61da94fef0f4
+ab5de698211e12b855c41377f80f45c07d828aab22a4c00d93a14cece1c8eac4

package/template/dotnet-scaffold/tests/__SolutionName__.Domain.Tests/obj/Debug/net10.0/__SolutionName__.Domain.Tests.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Domain.Tests")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Domain.Tests")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Domain.Tests")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/tests/__SolutionName__.Domain.Tests/obj/Debug/net10.0/__SolutionName__.Domain.Tests.AssemblyInfoInputs.cache

@@ -1 +1 @@
-04040ed34adc181e1bd5df5735ba14a0419ce9724bb1722c31d1d30a009810ea
+ce3c158015ef4927da9002b18c57bb2fb5a0265d0b907e0f6720f86daafbc84a

package/template/dotnet-scaffold/tests/__SolutionName__.Infrastructure.Tests/obj/Debug/net10.0/__SolutionName__.Infrastructure.Tests.AssemblyInfo.cs

@@ -13,7 +13,7 @@ using System.Reflection;
 [assembly: System.Reflection.AssemblyCompanyAttribute("__SolutionName__.Infrastructure.Tests")]
 [assembly: System.Reflection.AssemblyConfigurationAttribute("Debug")]
 [assembly: System.Reflection.AssemblyFileVersionAttribute("1.0.0.0")]
-[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+0342d5b9ce3d2a90f472edee8291747e8286b305")]
+[assembly: System.Reflection.AssemblyInformationalVersionAttribute("1.0.0+addeb6d651f63e02add936c1b3ac79b7bbed4cc0")]
 [assembly: System.Reflection.AssemblyProductAttribute("__SolutionName__.Infrastructure.Tests")]
 [assembly: System.Reflection.AssemblyTitleAttribute("__SolutionName__.Infrastructure.Tests")]
 [assembly: System.Reflection.AssemblyVersionAttribute("1.0.0.0")]

package/template/dotnet-scaffold/tests/__SolutionName__.Infrastructure.Tests/obj/Debug/net10.0/__SolutionName__.Infrastructure.Tests.AssemblyInfoInputs.cache

@@ -1 +1 @@
-bd11dccd376bd2500356241e2ec45b331c03c79362077c842f7b8a20ea73348c
+a0e0dba389287846acaf1c83c8152653d3b51188a2cac1d4afd9692cc3540e23