@litfamily/litcodex 1.0.17 → 1.0.19

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 (70) hide show
  1. package/README-Ko-KR.md +46 -147
  2. package/README.md +46 -150
  3. package/dist/auto-update.d.ts +2 -1
  4. package/dist/auto-update.js +2 -1
  5. package/dist/cli.d.ts +1 -1
  6. package/dist/cli.js +85 -5
  7. package/dist/config-migration/multi-agent-v2-guard.js +10 -21
  8. package/dist/config-migration/root-settings.js +30 -31
  9. package/dist/config-migration/toml-lines.d.ts +12 -0
  10. package/dist/config-migration/toml-lines.js +113 -0
  11. package/dist/config-migration/toml-shape.js +8 -15
  12. package/dist/install/codex.js +6 -3
  13. package/dist/install/doctor-render.js +19 -0
  14. package/dist/install/doctor-tui.d.ts +7 -0
  15. package/dist/install/doctor-tui.js +65 -0
  16. package/dist/install/doctor.js +2 -0
  17. package/dist/install/generated-skill-payload-hashes.d.ts +26 -25
  18. package/dist/install/generated-skill-payload-hashes.js +26 -25
  19. package/dist/install/index.d.ts +6 -1
  20. package/dist/install/index.js +16 -2
  21. package/dist/install/office-runtime.d.ts +1 -0
  22. package/dist/install/office-runtime.js +2 -2
  23. package/dist/install/types.d.ts +10 -0
  24. package/dist/install/uninstall.d.ts +2 -0
  25. package/dist/install/uninstall.js +12 -1
  26. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  27. package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.d.ts +16 -1
  28. package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.js +99 -13
  29. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  30. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  31. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  32. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  33. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  34. package/marketplace/plugins/litcodex/components/rules/dist/deliverable-hedge-guard.d.ts +6 -0
  35. package/marketplace/plugins/litcodex/components/rules/dist/deliverable-hedge-guard.js +10 -29
  36. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  37. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  38. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  39. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  40. package/marketplace/plugins/litcodex/hooks/hooks.json +1 -1
  41. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +1 -1
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +0 -1
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +0 -1
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +0 -1
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +0 -1
  46. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +0 -1
  47. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +0 -1
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/FORBIDDEN_TERMS.json +55 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +4 -4
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +4 -4
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +4 -4
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +6 -6
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +4 -4
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +4 -4
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +4 -4
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +4 -4
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +1 -1
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +13 -3
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +0 -13
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +0 -13
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +0 -13
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -14
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +0 -13
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +0 -13
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +0 -13
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +0 -13
  67. package/node_modules/@litcodex/lit-loop/README.md +1 -1
  68. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  69. package/package.json +12 -4
  70. package/readme-assets/badge-version.svg +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/comment-checker",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex Comment-Checker hook: flags low-value / AI-slop comments introduced by edits.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/git-bash",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex Git-Bash hook: reminds Windows sessions to prefer the git_bash MCP before the built-in shell.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lsp",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex LSP hook (inert placeholder): post-edit diagnostics + cache reset, no-op until an LSP daemon is provided.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -15,6 +15,12 @@ export interface HumanizerFinding {
15
15
  type GuardOptions = {
16
16
  readonly scan?: (text: string) => readonly HumanizerFinding[];
17
17
  };
18
+ /**
19
+ * Reader-facing prose formats. Block-tier rules are prose rules (a line-start `Source:` label, for
20
+ * example), so they apply only here; code and data files such as YAML keys or Python docstrings
21
+ * are never scanned.
22
+ */
23
+ export declare const HUMANIZER_PROSE_EXTENSIONS: ReadonlySet<string>;
18
24
  export declare function humanizerFailOpenOutput(event: "PreToolUse" | "PostToolUse"): string;
19
25
  /** Run the bundled detector. Its exit statuses 1 and 2 represent findings; 2 is also used for block hits. */
20
26
  export declare function inspectHumanizerText(text: string, detectorPath?: string): readonly HumanizerFinding[];
@@ -7,39 +7,20 @@ const MAX_PATHS = 64;
7
7
  const MAX_OUTPUT_BYTES = 512 * 1024;
8
8
  const DETECTOR_TIMEOUT_MS = 1500;
9
9
  const DEFAULT_DETECTOR = resolve(dirname(fileURLToPath(import.meta.url)), "../../../skills/lit-humanizer/scripts/detect.mjs");
10
- const TEXT_EXTENSIONS = new Set([
10
+ /**
11
+ * Reader-facing prose formats. Block-tier rules are prose rules (a line-start `Source:` label, for
12
+ * example), so they apply only here; code and data files such as YAML keys or Python docstrings
13
+ * are never scanned.
14
+ */
15
+ export const HUMANIZER_PROSE_EXTENSIONS = new Set([
11
16
  ".adoc",
12
- ".c",
13
- ".cc",
14
- ".cpp",
15
- ".css",
16
- ".csv",
17
- ".go",
18
- ".h",
19
17
  ".html",
20
- ".java",
21
- ".js",
22
- ".jsx",
23
- ".jsonc",
18
+ ".markdown",
24
19
  ".md",
25
20
  ".mdx",
26
- ".mjs",
27
- ".php",
28
- ".py",
29
- ".rb",
30
21
  ".rst",
31
- ".rs",
32
- ".sh",
33
- ".sql",
34
- ".svg",
35
22
  ".tex",
36
- ".toml",
37
- ".ts",
38
- ".tsx",
39
23
  ".txt",
40
- ".xml",
41
- ".yaml",
42
- ".yml",
43
24
  ]);
44
25
  const OFFICE_EXTENSIONS = new Set([".docx", ".pdf", ".pptx"]);
45
26
  const WRITER_TOOLS = new Set([
@@ -87,7 +68,7 @@ export function runHumanizerPreToolUse(input, options = {}) {
87
68
  return contextOutput("PreToolUse", FAIL_OPEN_NOTE);
88
69
  const text = writes
89
70
  .filter((part) => !isInternalPath(part.path) && !isOfficePath(part.path))
90
- .filter((part) => part.path === undefined || TEXT_EXTENSIONS.has(extname(part.path).toLowerCase()))
71
+ .filter((part) => part.path === undefined || HUMANIZER_PROSE_EXTENSIONS.has(extname(part.path).toLowerCase()))
91
72
  .map((part) => changedText(part, input.cwd))
92
73
  .join("\n\n");
93
74
  if (text.length === 0)
@@ -191,9 +172,9 @@ function collectPostToolPaths(input) {
191
172
  }
192
173
  return paths;
193
174
  }
194
- const WRITABLE_EXTENSIONS = new Set([...TEXT_EXTENSIONS, ...OFFICE_EXTENSIONS]);
175
+ const WRITABLE_EXTENSIONS = new Set([...HUMANIZER_PROSE_EXTENSIONS, ...OFFICE_EXTENSIONS]);
195
176
  function isTextPath(path) {
196
- return TEXT_EXTENSIONS.has(extname(path).toLowerCase());
177
+ return HUMANIZER_PROSE_EXTENSIONS.has(extname(path).toLowerCase());
197
178
  }
198
179
  function shellOutputPaths(command) {
199
180
  const intent = /(?:^|\s)(?:>>?|\d?>)\s*|--output(?:=|\s+)|\s-o\s+/iu.test(command);
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/rules",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex rules: injects project rule files (AGENTS.md etc.) into model context through lifecycle hooks.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/start-work-continuation",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex Start-Work continuation hook: resumes in-flight start-work state on root Stop.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/telemetry",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "LitCodex telemetry: a deliberately inert, local-only SessionStart hook (NO network, NO data collection).",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/wikify-knowledge",
3
- "version": "1.0.17",
3
+ "version": "1.0.19",
4
4
  "description": "Local review-gated knowledge records for the LitCodex Wikify surface.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -58,7 +58,7 @@
58
58
  {
59
59
  "type": "command",
60
60
  "command": "node \"${PLUGIN_ROOT}/components/auto-update/dist/cli.js\" hook session-start",
61
- "timeout": 60,
61
+ "timeout": 300,
62
62
  "statusMessage": "\ud83d\udd25 LIT IGNITED \u00b7 auto-update \ud83d\udd25"
63
63
  }
64
64
  ]
@@ -59,7 +59,7 @@ LABELS = {
59
59
  }
60
60
  PACK_KEYS = {"schema_version", "tonality", "summary", "dials", "docx", "design"}
61
61
  DESIGN_KEYS = {"ramp", "numbering", "h1_rule", "title_block", "contents", "summary_form", "conclusion_first", "running_head", "justify",
62
- "palette", "accent_on", "page_geometry", "components", "figure_style", "fill", "spacing"}
62
+ "palette", "accent_on", "page_geometry", "components", "figure_style", "spacing"}
63
63
  ACCENT_PLACES = ("title_rule", "callout_rule", "sidebar_rule")
64
64
  DIRECTIVE_KEYS = {
65
65
  "cover": {"variant", "image", "kicker"},
@@ -25,4 +25,3 @@ design:
25
25
  allowed: [callout, columns]
26
26
  callout_max: 1
27
27
  figure_style: {max_height_ratio: 0.40}
28
- fill: {min_page_fill: 0.35, target_median_fill: 0.80}
@@ -23,4 +23,3 @@ design:
23
23
  components:
24
24
  allowed: [callout]
25
25
  figure_style: {max_height_ratio: 0.40}
26
- fill: {min_page_fill: 0.35, target_median_fill: 0.80}
@@ -23,4 +23,3 @@ design:
23
23
  allowed: [callout, sidebar, columns]
24
24
  sidebar: {default_width: third, float: right}
25
25
  figure_style: {max_height_ratio: 0.45}
26
- fill: {min_page_fill: 0.35, target_median_fill: 0.80}
@@ -22,6 +22,5 @@ design:
22
22
  components:
23
23
  allowed: []
24
24
  figure_style: {max_height_ratio: 0.40}
25
- fill: {min_page_fill: 0.35, target_median_fill: 0.80}
26
25
  # A memo stays on one page when its content allows: the low end of the line pitch, less space around heads.
27
26
  spacing: tight
@@ -24,4 +24,3 @@ design:
24
24
  callout_max: 1
25
25
  keyfigures: {per_row: 3}
26
26
  figure_style: {max_height_ratio: 0.60}
27
- fill: {min_page_fill: 0.35, target_median_fill: 0.75}
@@ -24,4 +24,3 @@ design:
24
24
  allowed: [keyfigures, callout, columns]
25
25
  keyfigures: {per_row: 3}
26
26
  figure_style: {max_height_ratio: 0.45}
27
- fill: {min_page_fill: 0.35, target_median_fill: 0.80}
@@ -0,0 +1,55 @@
1
+ {
2
+ "case_insensitive": true,
3
+ "whole_word": false,
4
+ "terms": [
5
+ "click to add title",
6
+ "click to add subtitle",
7
+ "click to add text",
8
+ "content goes here",
9
+ "your logo",
10
+ "placeholder",
11
+ "lorem ipsum",
12
+ "tbd",
13
+ "fixme",
14
+ "todo",
15
+ "본 슬라이드는",
16
+ "슬라이드 7은",
17
+ "최종본에서 걸러냈다",
18
+ "[자사 확인 필요]",
19
+ "[출처 확인 필요]",
20
+ "[작성 중]"
21
+ ],
22
+ "soft_terms": [
23
+ "revolutionary",
24
+ "cutting-edge",
25
+ "seamless",
26
+ "seamlessly",
27
+ "innovative",
28
+ "world-class",
29
+ "best-in-class",
30
+ "transformative",
31
+ "next-generation",
32
+ "game-changing",
33
+ "state-of-the-art",
34
+ "AI-powered",
35
+ "AI-generated",
36
+ "as an AI",
37
+ "unlock",
38
+ "empower",
39
+ "synergy",
40
+ "holistic",
41
+ "paradigm shift",
42
+ "frictionless",
43
+ "없다는 것이 발견",
44
+ "판이 굳었다",
45
+ "전제로 깐다",
46
+ "닫아야 할 게이트",
47
+ "역전 금지",
48
+ "논문이 없다",
49
+ "RAM",
50
+ "FTO",
51
+ "CNKI",
52
+ "코퍼스",
53
+ "전이원"
54
+ ]
55
+ }
@@ -33,10 +33,10 @@ the deck honest about what the reader is looking at.
33
33
  | positive / negative | #1E7A3F / #B3261E |
34
34
  | series | #2B4C7E, #555B63, #8A6A2E, #3E7A5A |
35
35
  | faces | Pretendard Bold titles; Pretendard Regular body, labels, display and numerals (a lighter voice than the other packs); `faces: a2z` swaps display and numerals to A2Z Light |
36
- | type voice | tracking 0 titles, −1 display; proportional figures |
37
- | table | `light-grid`: no header fill, bold ink header, hairline rows, no banding, numbers right-aligned |
38
- | chart | hairline gridlines, direct labels, accent on the item that matters, no annotation |
39
- | image | bleed and crop allowed, no frame |
36
+ | type voice | tracking 0 titles, −1 display |
37
+ | table | no header fill, bold ink header, hairline rows, no banding, numbers right-aligned |
38
+ | chart | hairline gridlines, direct labels, accent on the item that matters |
39
+ | image | no frame |
40
40
  | decoration | caption band, hairline rule, colour field |
41
41
  | radius / edge | 0 / fill |
42
42
 
@@ -30,10 +30,10 @@ in the room and still works when students reopen the file a week later.
30
30
  | positive / negative | #1E7A3F / #B3261E |
31
31
  | series | #9A3412, #1F3B33, #4E5A66, #2E6A8E |
32
32
  | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` gives A2Z Bold display and titles, A2Z Black numerals |
33
- | type voice | tracking −1; proportional figures |
34
- | table | `header-fill`: accent-tint header with accent-deep text, row rules, bold totals |
35
- | chart | hairline gridlines, direct labels, accent on the highlighted series, annotation on |
36
- | image | bleed at the sides only, no crop, no frame |
33
+ | type voice | tracking −1 |
34
+ | table | accent-tint header with accent-deep text, row rules, bold totals |
35
+ | chart | hairline gridlines, direct labels, accent on the highlighted series |
36
+ | image | no frame |
37
37
  | decoration | accent rule, mark underline (listed, not drawn yet), rail fill in the field colour, numeral |
38
38
  | radius / edge | 6 / fill |
39
39
 
@@ -31,10 +31,10 @@ accent. Nobody presents a Gazette deck; it is opened at a desk, read in order, a
31
31
  | positive / negative | #1E7A3F / #1A2230 |
32
32
  | series | #A61B1B, #233A4F, #4A5568, #7A6A2A |
33
33
  | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` swaps display and numerals to A2Z Bold |
34
- | type voice | tracking −1, tabular figures |
35
- | table | `header-fill`: header in the slate field with white text, full grid rules, surface banding, bold totals |
36
- | chart | hairline gridlines, direct labels, accent on the highlighted series, no annotation |
37
- | image | no bleed, no crop, hairline frame |
34
+ | type voice | tracking −1 |
35
+ | table | header in the slate field with white text, full grid rules, surface banding, bold totals |
36
+ | chart | hairline gridlines, direct labels, accent on the highlighted series |
37
+ | image | hairline frame |
38
38
  | decoration | header band, box outline, hairline rule, numeral |
39
39
  | radius / edge | 0 / fill and border |
40
40
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Ledger treats a deck as an account book that has to survive questions. Pages are white and
4
4
  tightly set on the compact grid; tables carry a deep green header band with white labels, a rule
5
- under the header and another above the totals, and right-aligned tabular figures. One teal-green
5
+ under the header and another above the totals, and right-aligned figures. One teal-green
6
6
  accent marks the figure each slide is about. Sections open on a rule or a real part number, never
7
7
  on a colour field, so the deck stays quiet enough for a reader to compare numbers across pages.
8
8
 
@@ -21,7 +21,7 @@ on a colour field, so the deck stays quiet enough for a reader to compare number
21
21
 
22
22
  - A live pitch or a launch: its density buries a listener and its calm palette undersells the
23
23
  moment. Signal or Studio.
24
- - An image-led deck: pictures are framed small with a hairline and bleed only at the sides.
24
+ - An image-led deck: pictures are framed small with a hairline.
25
25
  - A deck built on single claims or quotations: Ledger has no `statement` treatment or family.
26
26
 
27
27
  ## Tokens
@@ -35,10 +35,10 @@ on a colour field, so the deck stays quiet enough for a reader to compare number
35
35
  | positive / negative | #1E7A3F / #B3261E |
36
36
  | series | #0E6B5A, #4B5866, #9A6A12, #2F5F8A |
37
37
  | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` swaps display and numerals to A2Z Bold |
38
- | type voice | tracking −1 on titles and display, sentence case, tabular figures |
39
- | table | `ledger`: header in the field colour with on-field text, rules under the header and above totals, no banding, bold totals |
40
- | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones, annotation on |
41
- | image | bleed at the sides only, no crop, hairline frame |
38
+ | type voice | tracking −1 on titles and display |
39
+ | table | header in the field colour with on-field text, rules under the header and above totals, no banding, bold totals |
40
+ | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones |
41
+ | image | hairline frame |
42
42
  | decoration | accent rule, hairline rule, rail fill, numeral |
43
43
  | radius / edge | 0 / fill |
44
44
 
@@ -33,10 +33,10 @@ thin pale type would vanish.
33
33
  | positive / negative | #6CC08B / #F08A7E |
34
34
  | series | #E3A857, #7FB8E0, #A3AEBA, #C58FD0 |
35
35
  | faces | Pretendard Bold (display, title), Pretendard Regular (body, labels, numerals); `faces: a2z` swaps numerals to A2Z Light |
36
- | type voice | tracking −1 titles, −2 display; tabular figures |
37
- | table | `header-fill`: surface header with ink text, row rules, protagonist row in accent tint, bold totals |
38
- | chart | hairline gridlines, direct labels, accent on the highlighted series, annotation on |
39
- | image | bleed at the sides, crop allowed, no frame |
36
+ | type voice | tracking −1 titles, −2 display |
37
+ | table | surface header with ink text, row rules, protagonist row in accent tint, bold totals |
38
+ | chart | hairline gridlines, direct labels, accent on the highlighted series |
39
+ | image | no frame |
40
40
  | decoration | header band, hairline rule, numeral, rail fill |
41
41
  | radius / edge | 6 / fill |
42
42
 
@@ -30,10 +30,10 @@ evidence without the design arguing for it.
30
30
  | positive / negative | #1E6B3A / #50565E |
31
31
  | series | #8C1C2B, #111418, #50565E, #2E5E8A |
32
32
  | faces | Pretendard Bold (display, title), Pretendard Regular (body, labels, numerals); the A2Z option changes nothing here |
33
- | type voice | tracking 0 titles, −1 display; tabular figures |
34
- | table | `booktabs`: no header fill, three rules (top, under header, bottom), no banding, bold totals |
35
- | chart | hairline gridlines, direct labels, series in palette order (the proposed method first), no annotation |
36
- | image | no bleed, no crop, no frame |
33
+ | type voice | tracking 0 titles, −1 display |
34
+ | table | no header fill, three rules (top, under header, bottom), no banding, bold totals |
35
+ | chart | hairline gridlines, direct labels, series in palette order (the proposed method first) |
36
+ | image | no frame |
37
37
  | decoration | hairline rule, box outline |
38
38
  | radius / edge | 0 / border |
39
39
 
@@ -32,10 +32,10 @@ so the file holds up when it is forwarded after the meeting.
32
32
  | positive / negative | #1E7A3F / #15131A (losses in ink with ▼, because red means "look here") |
33
33
  | series | #C8361A, #15131A, #6B6870, #2F6F8F |
34
34
  | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` gives A2Z Black display and numerals, A2Z Bold titles |
35
- | type voice | tracking −1 titles, −2 display; proportional figures |
36
- | table | `open`: no header fill, rules at top and bottom, protagonist row in accent tint, bold totals |
37
- | chart | no gridlines, direct labels, accent on the highlighted bar over muted ones, annotation on |
38
- | image | bleed and crop allowed, no frame |
35
+ | type voice | tracking −1 titles, −2 display |
36
+ | table | no header fill, rules at top and bottom, protagonist row in accent tint, bold totals |
37
+ | chart | no gridlines, direct labels, accent on the highlighted bar over muted ones |
38
+ | image | no frame |
39
39
  | decoration | colour field, hairline rule, numeral |
40
40
  | radius / edge | 0 / fill |
41
41
 
@@ -31,10 +31,10 @@ story, a public lecture.
31
31
  | positive / negative | #1E7A3F / #B3261E |
32
32
  | series | #8A5A00, #141414, #525252, #3B5F7F |
33
33
  | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` gives A2Z Black display and numerals, A2Z Medium titles |
34
- | type voice | tracking −1 titles, −2 display; proportional figures |
35
- | table | `open`: no header fill, one rule under the header, no banding, bold totals |
36
- | chart | no gridlines, direct labels, accent on the highlighted bar, annotation on |
37
- | image | bleed and crop allowed, no frame |
34
+ | type voice | tracking −1 titles, −2 display |
35
+ | table | no header fill, one rule under the header, no banding, bold totals |
36
+ | chart | no gridlines, direct labels, accent on the highlighted bar |
37
+ | image | no frame |
38
38
  | decoration | column hairlines, numeral, rail fill, colour field, caption band |
39
39
  | radius / edge | 0 / fill |
40
40
 
@@ -470,7 +470,7 @@ function validatePack(pack, file) {
470
470
  need(typeof pack.intent === "string" && pack.intent.length > 0, "intent is missing");
471
471
  need(isList(pack.canvas) && pack.canvas.length > 0 && pack.canvas.every((c) => grid.CANVAS[c]), "canvas must list 16:9 and/or 4:3");
472
472
  // `faces` is the deck's default and is Pretendard only; `faces-a2z` applies when the source asks.
473
- for (const key of ["faces", "faces-pretendard-only", "faces-a2z"]) {
473
+ for (const key of ["faces", "faces-a2z"]) {
474
474
  if (key === "faces-a2z" && pack[key] == null) continue;
475
475
  const faces = pack[key] || {};
476
476
  for (const role of FACE_KEYS) {
@@ -52,10 +52,20 @@ def _load_terms() -> tuple[list[str], list[str], bool, bool]:
52
52
  )
53
53
 
54
54
 
55
- def _build_regex(terms: list[str], case_insensitive: bool, whole_word: bool) -> re.Pattern[str] | None:
55
+ def _build_regex(terms: list[str], case_insensitive: bool, whole_word: bool, words: bool = False) -> re.Pattern[str] | None:
56
56
  if not terms:
57
57
  return None
58
- escaped = [re.escape(term) for term in terms]
58
+ # With words (the hard terms), a one-word Latin term ("todo", "tbd") must stand as a word or its plural
59
+ # ("TODOs"): inside "Mastodon" or "photodocument" it is not the placeholder. In either list an all-uppercase
60
+ # acronym ("RAM") stands as a word in capitals, whatever the file's case setting: "diagram", "my ram stick"
61
+ # and "Ram Das" hold none. Phrases, Hangul and bracketed terms still match anywhere.
62
+ def one(term: str) -> str:
63
+ if words and re.fullmatch(r"[A-Za-z]+", term):
64
+ return rf"(?<![A-Za-z]){re.escape(term)}s?(?![A-Za-z])"
65
+ if re.fullmatch(r"[A-Z]{2,}", term):
66
+ return rf"(?<![A-Za-z])(?-i:{re.escape(term)})(?![A-Za-z])"
67
+ return re.escape(term)
68
+ escaped = [one(term) for term in terms]
59
69
  pattern = "|".join(escaped)
60
70
  if whole_word:
61
71
  pattern = rf"(?:(?<=\W)|^)(?:{pattern})(?:(?=\W)|$)"
@@ -131,7 +141,7 @@ def _slide_has_title(slide, slide_height: int | None) -> bool:
131
141
  def lint(path: str | Path) -> dict[str, Any]:
132
142
  prs = Presentation(str(path))
133
143
  hard_terms, soft_terms, case_insensitive, whole_word = _load_terms()
134
- hard_re = _build_regex(hard_terms, case_insensitive, whole_word)
144
+ hard_re = _build_regex(hard_terms, case_insensitive, whole_word, words=True)
135
145
  soft_re = _build_regex(soft_terms, case_insensitive, whole_word)
136
146
 
137
147
  missing_titles: list[int] = []
@@ -14,12 +14,6 @@ faces:
14
14
  body: Pretendard Regular
15
15
  label: Pretendard Regular
16
16
  numeral: Pretendard Regular
17
- faces-pretendard-only:
18
- display: Pretendard Regular
19
- title: Pretendard Bold
20
- body: Pretendard Regular
21
- label: Pretendard Regular
22
- numeral: Pretendard Regular
23
17
  faces-a2z:
24
18
  display: A2Z Light
25
19
  title: Pretendard Bold
@@ -47,8 +41,6 @@ hero: false
47
41
  type-voice:
48
42
  title-tracking: 0
49
43
  display-tracking: -1
50
- latin-case: sentence
51
- figures: proportional
52
44
 
53
45
  density: 10
54
46
  variance: 7
@@ -80,21 +72,16 @@ sections: [section-image, section-field]
80
72
  closings: [closing-contact-split, closing-ask]
81
73
 
82
74
  table:
83
- style: light-grid
84
75
  header: none
85
76
  header-ink: ink
86
77
  rules: rows
87
78
  banding: none
88
- numbers: right-tabular
89
79
  totals: bold
90
80
  chart:
91
81
  gridlines: hairline
92
82
  labels: direct
93
83
  highlight: accent-on-muted
94
- annotation: off
95
84
  image:
96
- bleed: allowed
97
- crop: allowed
98
85
  frame: none
99
86
 
100
87
  fill-order: [anchor-visual, change-family, distribute, step-up]
@@ -14,12 +14,6 @@ faces:
14
14
  body: Pretendard Regular
15
15
  label: Pretendard Regular
16
16
  numeral: Pretendard Bold
17
- faces-pretendard-only:
18
- display: Pretendard Bold
19
- title: Pretendard Bold
20
- body: Pretendard Regular
21
- label: Pretendard Regular
22
- numeral: Pretendard Bold
23
17
  faces-a2z:
24
18
  display: A2Z Bold
25
19
  title: A2Z Bold
@@ -47,8 +41,6 @@ hero: false
47
41
  type-voice:
48
42
  title-tracking: -1
49
43
  display-tracking: -1
50
- latin-case: sentence
51
- figures: proportional
52
44
 
53
45
  density: 10
54
46
  variance: 6
@@ -86,21 +78,16 @@ sections: [section-numeral, section-rail]
86
78
  closings: [closing-summary-list, closing-ask]
87
79
 
88
80
  table:
89
- style: header-fill
90
81
  header: accent-tint
91
82
  header-ink: accent-deep
92
83
  rules: rows
93
84
  banding: none
94
- numbers: right-tabular
95
85
  totals: bold
96
86
  chart:
97
87
  gridlines: hairline
98
88
  labels: direct
99
89
  highlight: accent-on-muted
100
- annotation: on
101
90
  image:
102
- bleed: side-only
103
- crop: none
104
91
  frame: none
105
92
 
106
93
  fill-order: [distribute, step-up, change-family, anchor-visual]
@@ -14,12 +14,6 @@ faces:
14
14
  body: Pretendard Regular
15
15
  label: Pretendard Regular
16
16
  numeral: Pretendard Bold
17
- faces-pretendard-only:
18
- display: Pretendard Bold
19
- title: Pretendard Bold
20
- body: Pretendard Regular
21
- label: Pretendard Regular
22
- numeral: Pretendard Bold
23
17
  faces-a2z:
24
18
  display: A2Z Bold
25
19
  title: Pretendard Bold
@@ -47,8 +41,6 @@ hero: false
47
41
  type-voice:
48
42
  title-tracking: -1
49
43
  display-tracking: -1
50
- latin-case: sentence
51
- figures: tabular
52
44
 
53
45
  density: 10
54
46
  variance: 4
@@ -80,21 +72,16 @@ sections: [section-band, section-rule]
80
72
  closings: [closing-decision-box, closing-ask]
81
73
 
82
74
  table:
83
- style: header-fill
84
75
  header: field
85
76
  header-ink: on-field
86
77
  rules: grid
87
78
  banding: surface
88
- numbers: right-tabular
89
79
  totals: bold
90
80
  chart:
91
81
  gridlines: hairline
92
82
  labels: direct
93
83
  highlight: accent-on-muted
94
- annotation: off
95
84
  image:
96
- bleed: none
97
- crop: none
98
85
  frame: hairline
99
86
 
100
87
  fill-order: [step-up, distribute, change-family, anchor-visual]
@@ -1,4 +1,4 @@
1
- # Ledger: a numbers-first review read closely. Small exact type, tabular figures, tables and
1
+ # Ledger: a numbers-first review read closely. Small exact type, tables and
2
2
  # KPI rows doing most of the work; colour marks the current period and the one figure that
3
3
  # matters. Not for a pitch with little data or a briefing read as prose.
4
4
  id: ledger
@@ -14,12 +14,6 @@ faces:
14
14
  body: Pretendard Regular
15
15
  label: Pretendard Regular
16
16
  numeral: Pretendard Bold
17
- faces-pretendard-only:
18
- display: Pretendard Bold
19
- title: Pretendard Bold
20
- body: Pretendard Regular
21
- label: Pretendard Regular
22
- numeral: Pretendard Bold
23
17
  faces-a2z:
24
18
  display: A2Z Bold
25
19
  title: Pretendard Bold
@@ -47,8 +41,6 @@ hero: false
47
41
  type-voice:
48
42
  title-tracking: -1
49
43
  display-tracking: -1
50
- latin-case: sentence
51
- figures: tabular
52
44
 
53
45
  density: 10
54
46
  variance: 5
@@ -80,22 +72,17 @@ sections: [section-rule, section-numeral]
80
72
  closings: [closing-decision-box, closing-ask]
81
73
 
82
74
  table:
83
- style: ledger
84
75
  # The header row is the ledger's one dark mass: deep field, white labels.
85
76
  header: field
86
77
  header-ink: on-field
87
78
  rules: header-and-totals
88
79
  banding: none
89
- numbers: right-tabular
90
80
  totals: bold
91
81
  chart:
92
82
  gridlines: hairline
93
83
  labels: direct
94
84
  highlight: accent-on-muted
95
- annotation: on
96
85
  image:
97
- bleed: side-only
98
- crop: none
99
86
  frame: hairline
100
87
 
101
88
  fill-order: [step-up, distribute, anchor-visual, change-family]