@llipe.com/dev-tasks 0.16.2 → 0.17.0

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 (115) hide show
  1. package/.claude/agents/developer.md +8 -3
  2. package/.claude/agents/github-ops.md +187 -59
  3. package/.claude/agents/technical-writer.md +1 -1
  4. package/.claude/agents/verifier.md +10 -5
  5. package/.claude/commands/planner.md +110 -15
  6. package/.claude/commands/product-engineer.md +27 -3
  7. package/.claude/hooks/git-guard.sh +2 -2
  8. package/.claude/skills/activity-init/SKILL.md +4 -0
  9. package/.claude/skills/activity-publish-github/SKILL.md +84 -15
  10. package/.claude/skills/git-ops/SKILL.md +6 -6
  11. package/.claude/skills/implement/SKILL.md +29 -13
  12. package/.claude/skills/memo-cli-usage/REFERENCE.md +1 -0
  13. package/.claude/skills/memo-cli-usage/SKILL.md +3 -1
  14. package/.claude/skills/plan/SKILL.md +6 -0
  15. package/.github/agents/developer.agent.md +8 -3
  16. package/.github/agents/github-ops.agent.md +182 -64
  17. package/.github/agents/planner.agent.md +123 -28
  18. package/.github/agents/product-engineer.agent.md +27 -3
  19. package/.github/agents/technical-writer.agent.md +1 -1
  20. package/.github/agents/verifier.agent.md +10 -5
  21. package/.github/instructions/implement.instructions.md +29 -13
  22. package/.github/instructions/plan.instructions.md +6 -0
  23. package/.github/skills/activity-init/SKILL.md +4 -0
  24. package/.github/skills/activity-publish-github/SKILL.md +84 -15
  25. package/.github/skills/git-ops/SKILL.md +6 -6
  26. package/.github/skills/memo-cli-usage/REFERENCE.md +1 -0
  27. package/.github/skills/memo-cli-usage/SKILL.md +3 -1
  28. package/.kiro/agents/developer.md +8 -3
  29. package/.kiro/agents/github-ops.md +182 -64
  30. package/.kiro/agents/planner.md +123 -28
  31. package/.kiro/agents/product-engineer.md +27 -3
  32. package/.kiro/agents/technical-writer.md +1 -1
  33. package/.kiro/agents/verifier.md +10 -5
  34. package/.kiro/skills/activity-init/SKILL.md +4 -0
  35. package/.kiro/skills/activity-publish-github/SKILL.md +84 -15
  36. package/.kiro/skills/git-ops/SKILL.md +6 -6
  37. package/.kiro/skills/memo-cli-usage/REFERENCE.md +1 -0
  38. package/.kiro/skills/memo-cli-usage/SKILL.md +3 -1
  39. package/.kiro/steering/implement.md +29 -13
  40. package/.kiro/steering/plan.md +6 -0
  41. package/CHANGELOG.md +42 -0
  42. package/README.md +79 -7
  43. package/TESTING.md +108 -30
  44. package/dist/bin/dev-tasks.d.ts +1 -1
  45. package/dist/bin/dev-tasks.js +126 -4
  46. package/dist/bin/dev-tasks.js.map +1 -1
  47. package/dist/bin/parse-args.d.ts +49 -1
  48. package/dist/bin/parse-args.d.ts.map +1 -1
  49. package/dist/bin/parse-args.js +132 -11
  50. package/dist/bin/parse-args.js.map +1 -1
  51. package/dist/core/checks/decision-log-format.d.ts +24 -3
  52. package/dist/core/checks/decision-log-format.d.ts.map +1 -1
  53. package/dist/core/checks/decision-log-format.js +43 -3
  54. package/dist/core/checks/decision-log-format.js.map +1 -1
  55. package/dist/core/checks/index.d.ts +2 -0
  56. package/dist/core/checks/index.d.ts.map +1 -1
  57. package/dist/core/checks/index.js +1 -0
  58. package/dist/core/checks/index.js.map +1 -1
  59. package/dist/core/checks/roadmap.d.ts +40 -0
  60. package/dist/core/checks/roadmap.d.ts.map +1 -0
  61. package/dist/core/checks/roadmap.js +78 -0
  62. package/dist/core/checks/roadmap.js.map +1 -0
  63. package/dist/core/migrate-projects/answers.d.ts +63 -0
  64. package/dist/core/migrate-projects/answers.d.ts.map +1 -0
  65. package/dist/core/migrate-projects/answers.js +79 -0
  66. package/dist/core/migrate-projects/answers.js.map +1 -0
  67. package/dist/core/migrate-projects/apply.d.ts +51 -0
  68. package/dist/core/migrate-projects/apply.d.ts.map +1 -0
  69. package/dist/core/migrate-projects/apply.js +828 -0
  70. package/dist/core/migrate-projects/apply.js.map +1 -0
  71. package/dist/core/migrate-projects/classify.d.ts +93 -0
  72. package/dist/core/migrate-projects/classify.d.ts.map +1 -0
  73. package/dist/core/migrate-projects/classify.js +170 -0
  74. package/dist/core/migrate-projects/classify.js.map +1 -0
  75. package/dist/core/migrate-projects/conventions.d.ts +118 -0
  76. package/dist/core/migrate-projects/conventions.d.ts.map +1 -0
  77. package/dist/core/migrate-projects/conventions.js +213 -0
  78. package/dist/core/migrate-projects/conventions.js.map +1 -0
  79. package/dist/core/migrate-projects/gh.d.ts +40 -0
  80. package/dist/core/migrate-projects/gh.d.ts.map +1 -0
  81. package/dist/core/migrate-projects/gh.js +115 -0
  82. package/dist/core/migrate-projects/gh.js.map +1 -0
  83. package/dist/core/migrate-projects/index.d.ts +61 -0
  84. package/dist/core/migrate-projects/index.d.ts.map +1 -0
  85. package/dist/core/migrate-projects/index.js +183 -0
  86. package/dist/core/migrate-projects/index.js.map +1 -0
  87. package/dist/core/migrate-projects/local-reader.d.ts +8 -0
  88. package/dist/core/migrate-projects/local-reader.d.ts.map +1 -0
  89. package/dist/core/migrate-projects/local-reader.js +30 -0
  90. package/dist/core/migrate-projects/local-reader.js.map +1 -0
  91. package/dist/core/migrate-projects/map.d.ts +36 -0
  92. package/dist/core/migrate-projects/map.d.ts.map +1 -0
  93. package/dist/core/migrate-projects/map.js +75 -0
  94. package/dist/core/migrate-projects/map.js.map +1 -0
  95. package/dist/core/migrate-projects/plan.d.ts +71 -0
  96. package/dist/core/migrate-projects/plan.d.ts.map +1 -0
  97. package/dist/core/migrate-projects/plan.js +638 -0
  98. package/dist/core/migrate-projects/plan.js.map +1 -0
  99. package/dist/core/migrate-projects/planfile.d.ts +149 -0
  100. package/dist/core/migrate-projects/planfile.d.ts.map +1 -0
  101. package/dist/core/migrate-projects/planfile.js +608 -0
  102. package/dist/core/migrate-projects/planfile.js.map +1 -0
  103. package/dist/core/migrate-projects/roadmap.d.ts +43 -0
  104. package/dist/core/migrate-projects/roadmap.d.ts.map +1 -0
  105. package/dist/core/migrate-projects/roadmap.js +54 -0
  106. package/dist/core/migrate-projects/roadmap.js.map +1 -0
  107. package/dist/core/migrate-projects/snapshot.d.ts +91 -0
  108. package/dist/core/migrate-projects/snapshot.d.ts.map +1 -0
  109. package/dist/core/migrate-projects/snapshot.js +285 -0
  110. package/dist/core/migrate-projects/snapshot.js.map +1 -0
  111. package/dist/core/migrate-projects/summary.d.ts +27 -0
  112. package/dist/core/migrate-projects/summary.d.ts.map +1 -0
  113. package/dist/core/migrate-projects/summary.js +35 -0
  114. package/dist/core/migrate-projects/summary.js.map +1 -0
  115. package/package.json +8 -6
@@ -8,7 +8,20 @@
8
8
  * file (the column is intra-file only — a value that happens to match
9
9
  * another feature's `D-NN` is still dangling here).
10
10
  *
11
- * Uniqueness and `Phase` are hard failures. A dangling `Supersedes` is
11
+ * Every body row must also have exactly as many cells as its table's
12
+ * header (#245). `splitRow` splits on every `|`, and a Markdown-escaped
13
+ * pipe (`\|`) inside a cell is still a `|` to it: the row grows a cell
14
+ * and every later column slides one position right. Read positionally,
15
+ * that row yields garbage — a regex fragment in `Supersedes`, or, for a
16
+ * shift landing after `Supersedes`, a silently corrupted `Author` and
17
+ * `Date` with no finding at all. So a row whose cell count differs from
18
+ * the header's is reported as `cell-count-mismatch` and skipped, never
19
+ * read. Teaching `splitRow` the escape is deliberately not done here;
20
+ * the point is that corruption is loud, not that it is repaired.
21
+ *
22
+ * Uniqueness, `Phase`, and cell count are hard failures — a shifted row
23
+ * makes every column read from it untrustworthy, which is a defect in
24
+ * the file, not work in progress. A dangling `Supersedes` is
12
25
  * reported the same way docs-structure reports staleness (D-21's
13
26
  * precedent): printed, not failed, so a decision log mid-session — a
14
27
  * row citing a `Supersedes` ID not yet appended — never blocks
@@ -49,13 +62,19 @@ function splitRow(line) {
49
62
  * each is read independently by its own header, and all rows are
50
63
  * pooled — `ID` uniqueness and `Supersedes` resolution are file-wide,
51
64
  * not per-table (the format has one ID space for the whole file).
65
+ *
66
+ * A body row is read positionally only after its cell count is checked
67
+ * against the header's; a mismatched row is returned in `malformed`
68
+ * and never in `rows` (#245).
52
69
  */
53
70
  export function parseDecisionRows(content) {
54
71
  const lines = content.split("\n");
55
72
  const rows = [];
73
+ const malformed = [];
56
74
  let idCol = -1;
57
75
  let phaseCol = -1;
58
76
  let supersedesCol = -1;
77
+ let headerCount = 0;
59
78
  let inTable = false;
60
79
  for (let i = 0; i < lines.length; i++) {
61
80
  const line = lines[i];
@@ -76,6 +95,7 @@ export function parseDecisionRows(content) {
76
95
  supersedesCol = headerCells.indexOf("supersedes");
77
96
  if (idCol === -1)
78
97
  continue; // not a decision table
98
+ headerCount = headerCells.length;
79
99
  inTable = true;
80
100
  i++; // consume the separator row too
81
101
  continue;
@@ -83,6 +103,18 @@ export function parseDecisionRows(content) {
83
103
  if (isSeparatorRow(trimmed))
84
104
  continue;
85
105
  const cells = splitRow(trimmed);
106
+ // Before any positional read: a row that split into a different
107
+ // number of cells than its header has shifted columns, and every
108
+ // value read from it by index would be wrong.
109
+ if (cells.length !== headerCount) {
110
+ malformed.push({
111
+ line: i + 1,
112
+ firstCell: cells[0] ?? "",
113
+ cells: cells.length,
114
+ expected: headerCount,
115
+ });
116
+ continue;
117
+ }
86
118
  const id = cells[idCol];
87
119
  if (id === undefined || id.length === 0) {
88
120
  inTable = false;
@@ -94,16 +126,24 @@ export function parseDecisionRows(content) {
94
126
  supersedes: supersedesCol === -1 ? "" : (cells[supersedesCol] ?? ""),
95
127
  });
96
128
  }
97
- return rows;
129
+ return { rows, malformed };
98
130
  }
99
131
  /**
100
132
  * Check one decision log's already-read content. `path` is the
101
133
  * repo-relative path used only in finding messages.
102
134
  */
103
135
  export function checkDecisionLogContent(content, path) {
104
- const rows = parseDecisionRows(content);
136
+ const { rows, malformed } = parseDecisionRows(content);
105
137
  const failures = [];
106
138
  const staleness = [];
139
+ for (const bad of malformed) {
140
+ failures.push({
141
+ rule: "cell-count-mismatch",
142
+ path,
143
+ message: `${path}:${bad.line}: row '${bad.firstCell}' has ${bad.cells} cells, header has ${bad.expected}. ` +
144
+ "A '|' inside a cell — escaped as '\\|' or not — splits it; reword the cell without a pipe.",
145
+ });
146
+ }
107
147
  const seen = new Set();
108
148
  const ids = new Set(rows.map((r) => r.id));
109
149
  for (const row of rows) {
@@ -1 +1 @@
1
- {"version":3,"file":"decision-log-format.js","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"decision-log-format.js","sourceRoot":"","sources":["../../../core/checks/decision-log-format.ts"],"names":[],"mappings":"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"}
@@ -16,4 +16,6 @@ export { checkDecisionLogFormat, checkDecisionLogContent } from "./decision-log-
16
16
  export type { DecisionLogFinding, DecisionLogResult } from "./decision-log-format.js";
17
17
  export { checkGlossary, checkGlossaryContent, checkVocabularySection, checkVocabularyFiles, checkExportedIdentifiers, splitIdentifierWords, normalizeVocabularyWord, GLOSSARY_FILE, REQUIREMENTS_DIR, } from "./glossary.js";
18
18
  export type { GlossaryRule, GlossaryFinding, GlossaryResult } from "./glossary.js";
19
+ export { parseRoadmapTable, tableCells, ROADMAP_FILE, ROADMAP_HEADER, ROADMAP_STATUSES, } from "./roadmap.js";
20
+ export type { RoadmapRow, RoadmapStatus, RoadmapParseResult } from "./roadmap.js";
19
21
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
@@ -13,4 +13,5 @@
13
13
  export { checkDocsStructure } from "./docs-structure.js";
14
14
  export { checkDecisionLogFormat, checkDecisionLogContent } from "./decision-log-format.js";
15
15
  export { checkGlossary, checkGlossaryContent, checkVocabularySection, checkVocabularyFiles, checkExportedIdentifiers, splitIdentifierWords, normalizeVocabularyWord, GLOSSARY_FILE, REQUIREMENTS_DIR, } from "./glossary.js";
16
+ export { parseRoadmapTable, tableCells, ROADMAP_FILE, ROADMAP_HEADER, ROADMAP_STATUSES, } from "./roadmap.js";
16
17
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * The canonical `docs/roadmap.md` table, defined once (spec §16a A-59).
3
+ *
4
+ * `roadmap-parity.test.ts` checks this repository's roadmap with it, and
5
+ * `migrate projects` reads a consumer's roadmap with it, so the two can
6
+ * never disagree about what "canonical" means.
7
+ *
8
+ * Canonical: the first Markdown table in the file has exactly the six
9
+ * header cells below, at least one data row (a "partial table" is a
10
+ * canonical header with at least one row), six cells in every row, and a
11
+ * Status from the fixed set.
12
+ */
13
+ export declare const ROADMAP_FILE = "docs/roadmap.md";
14
+ export declare const ROADMAP_HEADER: readonly ["PRD", "Phase/Wave", "Scope (one line)", "Status", "Issues/PRs", "What's missing"];
15
+ export declare const ROADMAP_STATUSES: readonly ["Not started", "In progress", "Done"];
16
+ export type RoadmapStatus = (typeof ROADMAP_STATUSES)[number];
17
+ export interface RoadmapRow {
18
+ /** The PRD key: the PRD cell's link text, or the cell itself when it is not a link (A-55). */
19
+ prd: string;
20
+ /** The PRD cell's link target, or `null`. */
21
+ prdLink: string | null;
22
+ phase: string;
23
+ scope: string;
24
+ status: RoadmapStatus;
25
+ issues: string;
26
+ missing: string;
27
+ /** The row's source line, for messages. */
28
+ line: string;
29
+ }
30
+ export type RoadmapParseResult = {
31
+ ok: true;
32
+ rows: RoadmapRow[];
33
+ } | {
34
+ ok: false;
35
+ reason: string;
36
+ };
37
+ /** Split a Markdown table line into trimmed cells; `\|` stays inside its cell. */
38
+ export declare function tableCells(line: string): string[];
39
+ export declare function parseRoadmapTable(content: string): RoadmapParseResult;
40
+ //# sourceMappingURL=roadmap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../core/checks/roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAE9C,eAAO,MAAM,cAAc,8FAOjB,CAAC;AAEX,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjD;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA2CrE"}
@@ -0,0 +1,78 @@
1
+ /**
2
+ * The canonical `docs/roadmap.md` table, defined once (spec §16a A-59).
3
+ *
4
+ * `roadmap-parity.test.ts` checks this repository's roadmap with it, and
5
+ * `migrate projects` reads a consumer's roadmap with it, so the two can
6
+ * never disagree about what "canonical" means.
7
+ *
8
+ * Canonical: the first Markdown table in the file has exactly the six
9
+ * header cells below, at least one data row (a "partial table" is a
10
+ * canonical header with at least one row), six cells in every row, and a
11
+ * Status from the fixed set.
12
+ */
13
+ export const ROADMAP_FILE = "docs/roadmap.md";
14
+ export const ROADMAP_HEADER = [
15
+ "PRD",
16
+ "Phase/Wave",
17
+ "Scope (one line)",
18
+ "Status",
19
+ "Issues/PRs",
20
+ "What's missing",
21
+ ];
22
+ export const ROADMAP_STATUSES = ["Not started", "In progress", "Done"];
23
+ /** Split a Markdown table line into trimmed cells; `\|` stays inside its cell. */
24
+ export function tableCells(line) {
25
+ const body = line
26
+ .trim()
27
+ .replace(/^\|/, "")
28
+ .replace(/(?<!\\)\|$/, "");
29
+ return body.split(/(?<!\\)\|/).map((c) => c.trim());
30
+ }
31
+ const SEPARATOR = /^\|?(\s*:?-+:?\s*\|)+\s*:?-*:?\s*$/;
32
+ export function parseRoadmapTable(content) {
33
+ const lines = content.split(/\r?\n/);
34
+ const first = lines.findIndex((l) => l.trimStart().startsWith("|"));
35
+ if (first === -1)
36
+ return { ok: false, reason: "no table found" };
37
+ const table = [];
38
+ for (let i = first; i < lines.length && lines[i].trimStart().startsWith("|"); i++) {
39
+ table.push(lines[i]);
40
+ }
41
+ const header = tableCells(table[0]);
42
+ if (header.length !== ROADMAP_HEADER.length || header.some((c, i) => c !== ROADMAP_HEADER[i])) {
43
+ return {
44
+ ok: false,
45
+ reason: `the first table's header is not ${ROADMAP_HEADER.map((c) => `\`${c}\``).join(", ")}`,
46
+ };
47
+ }
48
+ if (table.length < 2 || !SEPARATOR.test(table[1].trim())) {
49
+ return { ok: false, reason: "the header is not followed by a separator row" };
50
+ }
51
+ const data = table.slice(2);
52
+ if (data.length === 0)
53
+ return { ok: false, reason: "the table has no rows" };
54
+ const rows = [];
55
+ for (const line of data) {
56
+ const cells = tableCells(line);
57
+ if (cells.length !== ROADMAP_HEADER.length) {
58
+ return { ok: false, reason: `wrong column count in: ${line}` };
59
+ }
60
+ const [prdCell, phase, scope, status, issues, missing] = cells;
61
+ if (!ROADMAP_STATUSES.includes(status)) {
62
+ return { ok: false, reason: `status outside ${ROADMAP_STATUSES.join(", ")} in: ${line}` };
63
+ }
64
+ const link = prdCell.match(/^\[([^\]]+)\]\(([^)]*)\)$/);
65
+ rows.push({
66
+ prd: link ? link[1] : prdCell,
67
+ prdLink: link ? link[2] : null,
68
+ phase,
69
+ scope,
70
+ status: status,
71
+ issues,
72
+ missing,
73
+ line,
74
+ });
75
+ }
76
+ return { ok: true, rows };
77
+ }
78
+ //# sourceMappingURL=roadmap.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"roadmap.js","sourceRoot":"","sources":["../../../core/checks/roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK;IACL,YAAY;IACZ,kBAAkB;IAClB,QAAQ;IACR,YAAY;IACZ,gBAAgB;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,MAAM,CAAU,CAAC;AAoBhF,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI;SACd,IAAI,EAAE;SACN,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,mCAAmC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC9F,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC7E,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,IAAI,EAAE,EAAE,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;QAC/D,IAAI,CAAE,gBAAsC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5F,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAC7B,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;YAC9B,KAAK;YACL,KAAK;YACL,MAAM,EAAE,MAAuB;YAC/B,MAAM;YACN,OAAO;YACP,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * The owner's answers, carried from the previous plan file into the next
3
+ * `--plan` (S-014 AC-6, task 4.7; spec §8.2, §16a A-50, A-73, A-83; CT-26).
4
+ *
5
+ * `--apply` never derives a write from an answer (A-50): `--plan` reads the
6
+ * answers, applies them before batching, and writes a fresh plan reading
7
+ * `Approved: no`, which the owner approves as rebuilt. An answered row stays
8
+ * in its review table with its answer, so a third `--plan` reads it again
9
+ * and produces the same plan (EC-134).
10
+ *
11
+ * Grammar, after the cell trim:
12
+ * - Unmapped: a roadmap wave id `<PRD key> <Phase/Wave>`, exactly as the
13
+ * roadmap cells read, or `standalone` in any letter case.
14
+ * - Needs a type: one of the eight types, with or without `type: `.
15
+ * - Needs a blocking link: `#<issue it blocks>` or `lower priority to high`.
16
+ * - Information: free text; only `yes` on a PRD question is read (A-83).
17
+ * Anything else is invalid: the item stays listed with the reason, and no
18
+ * write is made from it.
19
+ */
20
+ import { type IssueType } from "./conventions.js";
21
+ import type { MigrationPlan } from "./planfile.js";
22
+ import { type RoadmapRow } from "./roadmap.js";
23
+ export interface PreviousAnswers {
24
+ unmapped: Map<number, string>;
25
+ needsType: Map<number, string>;
26
+ needsBlockingLink: Map<number, string>;
27
+ /** Keyed by `informationKey(ref, note)`. */
28
+ information: Map<string, string>;
29
+ }
30
+ export declare function emptyAnswers(): PreviousAnswers;
31
+ export declare function informationKey(ref: string, note: string): string;
32
+ /** The non-empty answers in `plan`'s review tables. */
33
+ export declare function readAnswers(plan: MigrationPlan): PreviousAnswers;
34
+ export type UnmappedAnswer = {
35
+ kind: "none";
36
+ } | {
37
+ kind: "wave";
38
+ row: RoadmapRow;
39
+ } | {
40
+ kind: "standalone";
41
+ } | {
42
+ kind: "invalid";
43
+ text: string;
44
+ };
45
+ export declare function parseUnmappedAnswer(text: string, rows: readonly RoadmapRow[]): UnmappedAnswer;
46
+ /** The answered type, `"invalid"`, or `null` for no answer. */
47
+ export declare function parseTypeAnswer(text: string): IssueType | "invalid" | null;
48
+ export declare const LOWER_TO_HIGH = "lower priority to high";
49
+ export type BlockingAnswer = {
50
+ kind: "none";
51
+ } | {
52
+ kind: "blocks";
53
+ issue: number;
54
+ } | {
55
+ kind: "lower";
56
+ } | {
57
+ kind: "invalid";
58
+ text: string;
59
+ };
60
+ export declare function parseBlockingAnswer(text: string): BlockingAnswer;
61
+ /** `yes` on an Information question, in any letter case. */
62
+ export declare function isYes(text: string | undefined): boolean;
63
+ //# sourceMappingURL=answers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../../core/migrate-projects/answers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,4CAA4C;IAC5C,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,YAAY,IAAI,eAAe,CAO9C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,CAWhE;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,cAAc,CAK7F;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAK1E;AAED,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAKhE;AAED,4DAA4D;AAC5D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEvD"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * The owner's answers, carried from the previous plan file into the next
3
+ * `--plan` (S-014 AC-6, task 4.7; spec §8.2, §16a A-50, A-73, A-83; CT-26).
4
+ *
5
+ * `--apply` never derives a write from an answer (A-50): `--plan` reads the
6
+ * answers, applies them before batching, and writes a fresh plan reading
7
+ * `Approved: no`, which the owner approves as rebuilt. An answered row stays
8
+ * in its review table with its answer, so a third `--plan` reads it again
9
+ * and produces the same plan (EC-134).
10
+ *
11
+ * Grammar, after the cell trim:
12
+ * - Unmapped: a roadmap wave id `<PRD key> <Phase/Wave>`, exactly as the
13
+ * roadmap cells read, or `standalone` in any letter case.
14
+ * - Needs a type: one of the eight types, with or without `type: `.
15
+ * - Needs a blocking link: `#<issue it blocks>` or `lower priority to high`.
16
+ * - Information: free text; only `yes` on a PRD question is read (A-83).
17
+ * Anything else is invalid: the item stays listed with the reason, and no
18
+ * write is made from it.
19
+ */
20
+ import { TYPE_LABEL_PREFIX, TYPE_SET } from "./conventions.js";
21
+ import { waveId } from "./roadmap.js";
22
+ export function emptyAnswers() {
23
+ return {
24
+ unmapped: new Map(),
25
+ needsType: new Map(),
26
+ needsBlockingLink: new Map(),
27
+ information: new Map(),
28
+ };
29
+ }
30
+ export function informationKey(ref, note) {
31
+ return `${ref}\u0000${note}`;
32
+ }
33
+ /** The non-empty answers in `plan`'s review tables. */
34
+ export function readAnswers(plan) {
35
+ const a = emptyAnswers();
36
+ const put = (m, k, v) => {
37
+ if (v.length > 0)
38
+ m.set(k, v);
39
+ };
40
+ for (const r of plan.review.unmapped)
41
+ put(a.unmapped, r.issue, r.answer);
42
+ for (const r of plan.review.needsType)
43
+ put(a.needsType, r.issue, r.answer);
44
+ for (const r of plan.review.needsBlockingLink)
45
+ put(a.needsBlockingLink, r.issue, r.answer);
46
+ for (const r of plan.review.information)
47
+ put(a.information, informationKey(r.ref, r.note), r.answer);
48
+ return a;
49
+ }
50
+ export function parseUnmappedAnswer(text, rows) {
51
+ if (text.length === 0)
52
+ return { kind: "none" };
53
+ if (text.toLowerCase() === "standalone")
54
+ return { kind: "standalone" };
55
+ const hits = rows.filter((r) => waveId(r) === text);
56
+ return hits.length === 1 ? { kind: "wave", row: hits[0] } : { kind: "invalid", text };
57
+ }
58
+ /** The answered type, `"invalid"`, or `null` for no answer. */
59
+ export function parseTypeAnswer(text) {
60
+ if (text.length === 0)
61
+ return null;
62
+ const t = text.toLowerCase();
63
+ const name = t.startsWith(TYPE_LABEL_PREFIX) ? t.slice(TYPE_LABEL_PREFIX.length) : t;
64
+ return TYPE_SET.includes(name) ? name : "invalid";
65
+ }
66
+ export const LOWER_TO_HIGH = "lower priority to high";
67
+ export function parseBlockingAnswer(text) {
68
+ if (text.length === 0)
69
+ return { kind: "none" };
70
+ if (text.toLowerCase() === LOWER_TO_HIGH)
71
+ return { kind: "lower" };
72
+ const m = text.match(/^#(\d+)$/);
73
+ return m ? { kind: "blocks", issue: Number(m[1]) } : { kind: "invalid", text };
74
+ }
75
+ /** `yes` on an Information question, in any letter case. */
76
+ export function isYes(text) {
77
+ return text !== undefined && text.toLowerCase() === "yes";
78
+ }
79
+ //# sourceMappingURL=answers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"answers.js","sourceRoot":"","sources":["../../../core/migrate-projects/answers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ import { type GhRunner } from "./gh.js";
2
+ import type { LocalReader } from "./local-reader.js";
3
+ import { type MigrationPlanSummary } from "./summary.js";
4
+ /** The lock against two concurrent runs, relative to the repository root (A-80). */
5
+ export declare const MIGRATION_APPLY_LOCK = "workstream/.migration-projects.lock";
6
+ /** The plan-file store `--apply` reads and writes back; see `createPlanFileStore`. */
7
+ export interface MigrationApplyStore {
8
+ read(path: string): string | undefined;
9
+ write(path: string, content: string): void;
10
+ }
11
+ export interface MigrationApplyLock {
12
+ /** `false` when another run holds it. */
13
+ acquire(): boolean;
14
+ release(): void;
15
+ }
16
+ /** The real lock: a file created exclusively (`wx`), removed on release. */
17
+ export declare function createLockFile(path: string): MigrationApplyLock;
18
+ /** Hooks for tests and tracing; never changes what is written. */
19
+ export interface MigrationApplyObserver {
20
+ /** Called just before each write call, with the row's ID and the argv. */
21
+ beforeWrite?(id: string, argv: readonly string[]): void;
22
+ }
23
+ export interface MigrationApplyRunOptions {
24
+ runner: GhRunner;
25
+ reader: LocalReader;
26
+ /** `--plan-file`, as the user typed it. */
27
+ planFile: string;
28
+ store: MigrationApplyStore;
29
+ lock: MigrationApplyLock;
30
+ /** Where body files go; a fresh directory under the OS temp dir by default, removed after. */
31
+ tmpDir?: string;
32
+ observer?: MigrationApplyObserver;
33
+ }
34
+ export interface MigrationApplyRunResult {
35
+ exitCode: number;
36
+ repo: string | null;
37
+ planFile: string;
38
+ /** The plan file's counts after the run; `null` when it could not be read. */
39
+ summary: MigrationPlanSummary | null;
40
+ /** Batch 7's steps, printed for the user to run (D-81). */
41
+ steps: string[];
42
+ /** Set on a non-zero exit: what went wrong and what to do. */
43
+ error?: string;
44
+ }
45
+ /** `migrate projects --apply`. Returns an exit code from `core/exit-codes.ts`; never throws for an expected failure. */
46
+ export declare function runMigrationApply(options: MigrationApplyRunOptions): Promise<MigrationApplyRunResult>;
47
+ /** The one-screen summary: per-batch states, what still waits for an answer, batch 7's steps. */
48
+ export declare function formatMigrationApplySummary(r: MigrationApplyRunResult): string;
49
+ /** The `--json` shape (A-64), `mode: "apply"`. */
50
+ export declare function migrationApplyJson(r: MigrationApplyRunResult): Record<string, unknown>;
51
+ //# sourceMappingURL=apply.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../core/migrate-projects/apply.ts"],"names":[],"mappings":"AAgEA,OAAO,EAA8C,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,OAAO,EAAyC,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEhG,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAE1E,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,OAAO,IAAI,OAAO,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA0B/D;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,kBAAkB,CAAC;IACzB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6lBD,wHAAwH;AACxH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA2KlC;AAID,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAwB9E;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBtF"}