@litfamily/litcodex 1.0.23 β†’ 1.0.24

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 (49) hide show
  1. package/README-Ko-KR.md +9 -9
  2. package/README.md +9 -9
  3. package/dist/install/generated-skill-payload-hashes.d.ts +12 -12
  4. package/dist/install/generated-skill-payload-hashes.js +12 -12
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.d.ts +1 -1
  10. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-html.js +65 -26
  11. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-mcp.js +26 -5
  12. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.d.ts +2 -0
  13. package/marketplace/plugins/litcodex/components/lit-loop/dist/card-status.js +9 -5
  14. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.d.ts +5 -2
  15. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +10 -11
  16. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.d.ts +9 -1
  17. package/marketplace/plugins/litcodex/components/lit-loop/dist/live-step.js +23 -5
  18. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  19. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  20. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  21. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  22. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  23. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  24. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +2 -2
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +1 -1
  26. package/marketplace/plugins/litcodex/skills/lit-humanizer/references/taxonomy.md +2 -0
  27. package/marketplace/plugins/litcodex/skills/lit-humanizer/rules.json +52 -1
  28. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +2 -2
  29. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +3 -4
  30. package/marketplace/plugins/litcodex/skills/lit-pptx/references/data-display-cookbook.md +1 -1
  31. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +1 -1
  32. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +1 -1
  33. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +1 -1
  34. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +2 -2
  35. package/marketplace/plugins/litcodex/skills/lit-pptx/specs/markdown-slide-spec-v1.md +1 -1
  36. package/node_modules/@litcodex/lit-loop/dist/card-html.d.ts +1 -1
  37. package/node_modules/@litcodex/lit-loop/dist/card-html.js +65 -26
  38. package/node_modules/@litcodex/lit-loop/dist/card-mcp.js +26 -5
  39. package/node_modules/@litcodex/lit-loop/dist/card-status.d.ts +2 -0
  40. package/node_modules/@litcodex/lit-loop/dist/card-status.js +9 -5
  41. package/node_modules/@litcodex/lit-loop/dist/hook-cli.d.ts +5 -2
  42. package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +10 -11
  43. package/node_modules/@litcodex/lit-loop/dist/live-step.d.ts +9 -1
  44. package/node_modules/@litcodex/lit-loop/dist/live-step.js +23 -5
  45. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  46. package/node_modules/@litcodex/lit-loop/skills/lit-humanizer/references/taxonomy.md +2 -0
  47. package/node_modules/@litcodex/lit-loop/skills/lit-humanizer/rules.json +52 -1
  48. package/package.json +2 -2
  49. package/readme-assets/badge-version.svg +1 -1
@@ -4,16 +4,28 @@
4
4
  // the `openai/outputTemplate` alias the Codex desktop app also reads) and returns the text map, so a
5
5
  // host that draws no card still gets something useful. `lit_card_status` is for the card only
6
6
  // (`visibility: ["app"]`, so the model and the terminal never list it); the card polls it with the
7
- // thread id the host adds to `_meta`. Both are read-only. The module has no side effects at import.
7
+ // thread id the host adds to `_meta`. Each LIT turn opens a fresh card next to the newest turn: `lit_card`
8
+ // records when it opened in the thread pointer and tells the new card that time, every poll carries the
9
+ // newest time, and an older card that sees a later one folds into a single line and stops polling. That
10
+ // timestamp in LitCodex's own pointer is the only write; nothing in the workspace or the user's files
11
+ // changes, so both tools keep their read-only hint. The module has no side effects at import.
8
12
  import { createHash } from "node:crypto";
9
13
  import { CARD_HTML } from "./card-html.js";
10
14
  import { cardStatusText, readCardStatus } from "./card-status.js";
15
+ import { recordCardOpened } from "./live-step.js";
11
16
  export const CARD_TOOL = "lit_card";
12
17
  export const CARD_STATUS_TOOL = "lit_card_status";
13
18
  export const CARD_MIME = "text/html;profile=mcp-app";
14
19
  const SERVER_INFO = { name: "litcodex", title: "LIT card", version: "1" };
15
20
  const PROTOCOL_VERSIONS = new Set(["2024-11-05", "2025-03-26", "2025-06-18", "2025-11-25"]);
16
21
  const DEFAULT_PROTOCOL = "2025-06-18";
22
+ /**
23
+ * The inline frame is max(the card's reported height, this floor); 200 by default, which left blank
24
+ * space under the card. The floor is the folded one-line card, so the frame follows the card.
25
+ */
26
+ const MIN_FRAME_HEIGHT = 28;
27
+ /** The working card's usual height, so the first paint is close before the card reports its own. */
28
+ const HEIGHT_HINT = 135;
17
29
  /** Without a thread id nothing is known about the thread, so the text claims nothing about it. */
18
30
  const NO_THREAD_TEXT = "πŸ”₯ LIT Β· the host did not name the thread, so there is no LIT state to show here.";
19
31
  let resourceUri = null;
@@ -31,7 +43,7 @@ function tools() {
31
43
  {
32
44
  name: CARD_TOOL,
33
45
  title: "LIT card",
34
- description: "Opens the live LIT card for this thread: the LIT activation, the workflow map and the step running now. It updates by itself. Call it once per thread, when the LIT activation context asks for it. In a host without cards it returns the same map as text.",
46
+ description: "Opens a live LIT card for this LIT turn: the LIT activation, the workflow map and the step running now. It updates by itself, and the card of the previous LIT turn folds into one line. Call it once per LIT turn, when the LIT activation context asks for it. In a host without cards it returns the same map as text.",
35
47
  inputSchema: { type: "object", properties: {}, additionalProperties: false },
36
48
  annotations: { title: "LIT card", readOnlyHint: true, destructiveHint: false, openWorldHint: false },
37
49
  _meta: { ui: { resourceUri: uri, visibility: ["model", "app"] }, "openai/outputTemplate": uri },
@@ -69,12 +81,17 @@ function threadOf(params) {
69
81
  }
70
82
  function callTool(params, context) {
71
83
  const thread = threadOf(params);
72
- const status = readCardStatus(thread, context.env, context.now());
84
+ const now = context.now();
73
85
  if (params["name"] === CARD_STATUS_TOOL) {
86
+ const status = readCardStatus(thread, context.env, now);
74
87
  return { content: [{ type: "text", text: JSON.stringify(status) }], structuredContent: status };
75
88
  }
89
+ if (thread !== null)
90
+ recordCardOpened(context.env, thread, now);
91
+ const status = readCardStatus(thread, context.env, now);
76
92
  const text = thread === null ? NO_THREAD_TEXT : cardStatusText(status);
77
- return { content: [{ type: "text", text }], structuredContent: status };
93
+ // The card keeps this time as its own; polls only ever say which card is the newest.
94
+ return { content: [{ type: "text", text }], structuredContent: { ...status, card: { openedAt: now } } };
78
95
  }
79
96
  function result(id, value) {
80
97
  return { jsonrpc: "2.0", id, result: value };
@@ -127,7 +144,11 @@ export function handleCardMessage(message, context) {
127
144
  uri: cardResourceUri(),
128
145
  mimeType: CARD_MIME,
129
146
  text: CARD_HTML,
130
- _meta: { ui: { prefersBorder: false } },
147
+ _meta: {
148
+ ui: { prefersBorder: false },
149
+ "openai/widgetMinFrameHeight": MIN_FRAME_HEIGHT,
150
+ "openai/widgetHeightHint": HEIGHT_HINT,
151
+ },
131
152
  },
132
153
  ],
133
154
  });
@@ -25,6 +25,8 @@ export interface CardStatus {
25
25
  readonly branch: string | null;
26
26
  /** Folder name of the workspace only; the full path stays out of the card. */
27
27
  readonly workspace: string | null;
28
+ /** When the newest card of this thread opened; an older card that sees a later time folds itself. */
29
+ readonly cardOpenedAt: number | null;
28
30
  readonly now: number;
29
31
  }
30
32
  export interface Usage {
@@ -5,7 +5,8 @@
5
5
  // live step. The workspace comes from the owned pointer first; Codex's own rollout header is read only
6
6
  // when no pointer exists yet, because its format is private. The rollout's last token count gives the
7
7
  // context and quota use for the bottom row; when that format moves, the row simply stays empty. Thread ids are normalized before they
8
- // touch a path, every file read is size-capped and refuses symlinks, and nothing here writes.
8
+ // touch a path, every file read is size-capped and refuses symlinks, and nothing here writes; the one
9
+ // write of the card server, the time a card opened, lives in live-step.ts.
9
10
  import { closeSync, fstatSync, readdirSync, readSync } from "node:fs";
10
11
  import { basename, isAbsolute, join } from "node:path";
11
12
  import { codexHomeFrom, openRegularFile, plainDirs, readLiveStep, readThreadPointer, } from "./live-step.js";
@@ -259,7 +260,7 @@ function finishedMap(map) {
259
260
  next: null,
260
261
  };
261
262
  }
262
- function ready(thread, workspace, now) {
263
+ function ready(thread, workspace, cardOpenedAt, now) {
263
264
  return {
264
265
  version: 1,
265
266
  thread,
@@ -276,6 +277,7 @@ function ready(thread, workspace, now) {
276
277
  usage: null,
277
278
  branch: null,
278
279
  workspace,
280
+ cardOpenedAt,
279
281
  now,
280
282
  };
281
283
  }
@@ -297,14 +299,15 @@ export function readCardStatus(threadId, env, now = Date.now()) {
297
299
  const cwd = resolveThreadCwd(threadId, env);
298
300
  const thread = cwd === null ? null : threadId;
299
301
  if (cwd === null || thread === null)
300
- return ready(null, null, now);
302
+ return ready(null, null, null, now);
301
303
  const workspace = basename(cwd);
304
+ const cardOpenedAt = readThreadPointer(env, thread)?.cardOpenedAt ?? null;
302
305
  // Every saved state lives under `.litcodex`; a symlink there would point the card at foreign files.
303
306
  if (!plainDirs(cwd, ".litcodex"))
304
- return ready(thread, workspace, now);
307
+ return ready(thread, workspace, cardOpenedAt, now);
305
308
  const turn = workflowTurn(cwd, thread);
306
309
  if (turn === null)
307
- return ready(thread, workspace, now);
310
+ return ready(thread, workspace, cardOpenedAt, now);
308
311
  const signals = readWorkflowSignals(cwd, thread, now);
309
312
  const drawn = workflowMapCells(turn.mode, signals);
310
313
  const live = readLiveStep(cwd, thread);
@@ -340,6 +343,7 @@ export function readCardStatus(threadId, env, now = Date.now()) {
340
343
  usage: readUsage(thread, env),
341
344
  branch: readBranch(cwd),
342
345
  workspace,
346
+ cardOpenedAt,
343
347
  now,
344
348
  };
345
349
  }
@@ -21,8 +21,11 @@ export interface AutoHandoffHookOptions {
21
21
  readonly env?: NodeJS.ProcessEnv;
22
22
  readonly now?: number;
23
23
  }
24
- /** Asks the model to open the LIT card; in the terminal `codex` the same tool returns the map as text. */
25
- export declare const CARD_OFFER_CONTEXT = "LIT card: if the `lit_card` tool (litcodex MCP server) is available, call the `lit_card` tool once now, with no arguments, so the user sees the live LIT card for this thread. Do not call it again in this thread; it updates by itself.";
24
+ /**
25
+ * Asks the model to open the LIT card for this LIT turn, so the live card sits next to the newest turn
26
+ * instead of scrolling away with the first one. In the terminal `codex` the same tool returns the map as text.
27
+ */
28
+ export declare const CARD_OFFER_CONTEXT = "LIT card: if the `lit_card` tool (litcodex MCP server) is available, call the `lit_card` tool once now, with no arguments, so the user sees the live LIT card for this turn. It replaces the previous turn's card, which folds itself into one line. Do not call it again in this turn; it updates by itself.";
26
29
  /** Injectable Jev dependencies; production uses the process environment and built-in `fetch`. */
27
30
  export interface JevHookOptions {
28
31
  readonly env?: NodeJS.ProcessEnv;
@@ -14,7 +14,7 @@ import { claimReloadContext, evaluateAutoHandoffStop, recordCompaction, takeRelo
14
14
  import { applyAutoHandoffRoute, clearManagedCompactionWhenOff, parseAutoHandoffRoute, } from "./auto-handoff-settings.js";
15
15
  import { applyPreToolUseCreateGoalGuard, isLitUserPromptSubmitInput, runUserPromptSubmitHook } from "./codex-hook.js";
16
16
  import { claimJevOnBanner, formatJevHookOutput, jevSwitchState, runJevSkillHint, withJevBanner, } from "./jev-hint.js";
17
- import { endLiveStep, readThreadPointer, recordLiveStepEnd, recordLiveStepStart, recordTurnStart, writeThreadPointer, } from "./live-step.js";
17
+ import { endLiveStep, recordLiveStepEnd, recordLiveStepStart, recordTurnStart, writeThreadPointer, } from "./live-step.js";
18
18
  import { evaluatePlanPersistence, formatStopBlockOutput, recordLitPlanActivation } from "./plan-persistence.js";
19
19
  import { recordWorkflowTurn, workflowMapLine, workflowStopLine, workflowTurn } from "./workflow-map.js";
20
20
  /** Hard cap on stdin to bound memory / ReDoS exposure inside the 5 s Codex hook budget. 8 MB. */
@@ -200,21 +200,20 @@ function withWorkflowMap(stdout, parsed, mode) {
200
200
  return stdout;
201
201
  }
202
202
  }
203
- /** Asks the model to open the LIT card; in the terminal `codex` the same tool returns the map as text. */
204
- export const CARD_OFFER_CONTEXT = "LIT card: if the `lit_card` tool (litcodex MCP server) is available, call the `lit_card` tool once now, with no arguments, so the user sees the live LIT card for this thread. Do not call it again in this thread; it updates by itself.";
205
- function offered(env, sessionId) {
206
- return (readThreadPointer(env, sessionId)?.cardOfferedAt ?? null) !== null;
207
- }
208
- /** Add the card request to the first LIT activation of a thread, and remember that it was made. */
203
+ /**
204
+ * Asks the model to open the LIT card for this LIT turn, so the live card sits next to the newest turn
205
+ * instead of scrolling away with the first one. In the terminal `codex` the same tool returns the map as text.
206
+ */
207
+ export const CARD_OFFER_CONTEXT = "LIT card: if the `lit_card` tool (litcodex MCP server) is available, call the `lit_card` tool once now, with no arguments, so the user sees the live LIT card for this turn. It replaces the previous turn's card, which folds itself into one line. Do not call it again in this turn; it updates by itself.";
208
+ /** Add the card request to every LIT activation, and remember when it was last made. */
209
209
  function withCardOffer(stdout, scope, auto) {
210
- const env = auto.env ?? process.env;
211
- if (scope === null || stdout === "" || offered(env, scope.sessionId))
210
+ if (scope === null || stdout === "")
212
211
  return stdout;
213
212
  const merged = withReloadContext(stdout, CARD_OFFER_CONTEXT);
214
213
  if (merged === null)
215
214
  return stdout;
216
- writeThreadPointer(env, scope.sessionId, scope.cwd, auto.now, { cardOffered: true });
217
- return offered(env, scope.sessionId) ? merged : stdout;
215
+ writeThreadPointer(auto.env ?? process.env, scope.sessionId, scope.cwd, auto.now, { cardOffered: true });
216
+ return merged;
218
217
  }
219
218
  function isRecord(value) {
220
219
  return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -12,6 +12,8 @@ export interface ThreadPointer {
12
12
  readonly cwd: string;
13
13
  readonly updatedAt: number;
14
14
  readonly cardOfferedAt: number | null;
15
+ /** When the `lit_card` tool last opened a card in this thread; the newest card is the live one. */
16
+ readonly cardOpenedAt: number | null;
15
17
  }
16
18
  export interface ToolRef {
17
19
  readonly tool: string;
@@ -53,7 +55,13 @@ export declare function endLiveStep(repoRoot: string, sessionId: string, now?: n
53
55
  export declare function codexHomeFrom(env: NodeJS.ProcessEnv): string | null;
54
56
  export declare function threadPointerPath(env: NodeJS.ProcessEnv, threadId: string): string | null;
55
57
  export declare function readThreadPointer(env: NodeJS.ProcessEnv, threadId: string): ThreadPointer | null;
56
- /** Point the thread at `cwd`; skips the write when the pointer already says so. */
58
+ /** Point the thread at `cwd`, keeping the card times it already holds; skips the write when nothing changes. */
57
59
  export declare function writeThreadPointer(env: NodeJS.ProcessEnv, threadId: string, cwd: string, now?: number, options?: {
58
60
  readonly cardOffered?: boolean;
61
+ readonly cardOpened?: boolean;
59
62
  }): void;
63
+ /**
64
+ * Remember that a card opened in this thread now, so every poll can tell the older cards to fold. Only a
65
+ * thread the hooks already pointed at a workspace is recorded; returns the time recorded, or null.
66
+ */
67
+ export declare function recordCardOpened(env: NodeJS.ProcessEnv, threadId: string, now?: number): number | null;
@@ -5,7 +5,8 @@
5
5
  // clears it. It also says whether the turn is still open: a LIT prompt opens it and Stop closes it, so
6
6
  // the card can tell a model that is thinking between tools from one that has answered and waits. The pointer lives in the Codex home the hook sees (`litcodex/lit-loop/threads/<session>.json`)
7
7
  // and maps a session id, which the desktop app also sends as its thread id, to the hook's `cwd`, because
8
- // the card server is started in the plugin folder and learns nothing else about the thread. Every write
8
+ // the card server is started in the plugin folder and learns nothing else about the thread. The pointer
9
+ // also keeps when the newest card of the thread opened, so an older card can fold itself away. Every write
9
10
  // is atomic, skips symlinked folders and never throws; every read is size-capped and refuses symlinks.
10
11
  import { randomBytes } from "node:crypto";
11
12
  import { closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, readSync, renameSync, rmSync, writeFileSync, } from "node:fs";
@@ -263,12 +264,13 @@ export function readThreadPointer(env, threadId) {
263
264
  const record = readSmallJson(path);
264
265
  if (!isRecord(record) || record["version"] !== 1)
265
266
  return null;
266
- const { cwd, updatedAt, cardOfferedAt } = record;
267
+ const { cwd, updatedAt, cardOfferedAt, cardOpenedAt } = record;
267
268
  if (typeof cwd !== "string" || !isAbsolute(cwd) || typeof updatedAt !== "number")
268
269
  return null;
269
- return { cwd, updatedAt, cardOfferedAt: typeof cardOfferedAt === "number" ? cardOfferedAt : null };
270
+ const time = (value) => (typeof value === "number" && Number.isFinite(value) ? value : null);
271
+ return { cwd, updatedAt, cardOfferedAt: time(cardOfferedAt), cardOpenedAt: time(cardOpenedAt) };
270
272
  }
271
- /** Point the thread at `cwd`; skips the write when the pointer already says so. */
273
+ /** Point the thread at `cwd`, keeping the card times it already holds; skips the write when nothing changes. */
272
274
  export function writeThreadPointer(env, threadId, cwd, now = Date.now(), options = {}) {
273
275
  const path = threadPointerPath(env, threadId);
274
276
  const home = codexHomeFrom(env);
@@ -276,12 +278,28 @@ export function writeThreadPointer(env, threadId, cwd, now = Date.now(), options
276
278
  return;
277
279
  const current = readThreadPointer(env, threadId);
278
280
  const cardOfferedAt = options.cardOffered === true ? now : (current?.cardOfferedAt ?? null);
279
- if (current !== null && current.cwd === cwd && current.cardOfferedAt === cardOfferedAt)
281
+ const cardOpenedAt = options.cardOpened === true ? now : (current?.cardOpenedAt ?? null);
282
+ if (current !== null &&
283
+ current.cwd === cwd &&
284
+ current.cardOfferedAt === cardOfferedAt &&
285
+ current.cardOpenedAt === cardOpenedAt)
280
286
  return;
281
287
  writeRecord(home, POINTER_DIR, basename(path), {
282
288
  version: 1,
283
289
  cwd,
284
290
  updatedAt: now,
285
291
  cardOfferedAt,
292
+ cardOpenedAt,
286
293
  });
287
294
  }
295
+ /**
296
+ * Remember that a card opened in this thread now, so every poll can tell the older cards to fold. Only a
297
+ * thread the hooks already pointed at a workspace is recorded; returns the time recorded, or null.
298
+ */
299
+ export function recordCardOpened(env, threadId, now = Date.now()) {
300
+ const current = readThreadPointer(env, threadId);
301
+ if (current === null)
302
+ return null;
303
+ writeThreadPointer(env, threadId, current.cwd, now, { cardOpened: true });
304
+ return readThreadPointer(env, threadId)?.cardOpenedAt === now ? now : null;
305
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.23",
3
+ "version": "1.0.24",
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,
@@ -17,6 +17,8 @@ This original category comes from the 26 real lines in fixtures/pos-real.txt and
17
17
  - ko-bracket-status-tag and en-bracket-status-tag β€” ko/en, block. Replace bracket keys with a sentence describing the status.
18
18
  - ko-standalone-scope-disclaimer and en-standalone-scope-disclaimer β€” ko/en, block for stock disclaimers. Preserve a user-requested legal, medical or safety notice and place it once where it applies.
19
19
  - ko-status-negation, ko-mi-status, en-epistemic-negation and en-not-performed β€” warnings. A negative result or unperformed action may be the finding. Write the actor, scope and verb plainly; never turn unknown into false or an estimate into a fact.
20
+ - ko-negative-pledge, ko-negative-pledge-repeat and en-negative-pledge β€” ko/en, block. A sentence that says what the document, table or number is not for (not a comparison, not a ranking, not to be read as a conclusion, not a public-use figure, the deck makes no claim) is a pledge about the artifact, not a finding. In a Codex edit it is refused before the write lands, so rewrite it: put the purpose boundary in the chat reply, or turn it into the fact it protects, written once beside the number it affects ("μƒ˜ν”Œμ€ ν•œ 곡정 쑰건만 ν¬ν•¨ν•œλ‹€"). ko-negative-pledge is line-scoped and matches a self-reference subject with a negated claim verb, a comparison or ranking noun with a negated use verb, or a purpose-용 data noun with μ•„λ‹˜; ko-negative-pledge-repeat fires when two such disclaimer sentences share a document; en-negative-pledge needs a comparison, benchmark or ranking noun. Operating rules (방폭 κ΅¬μ—­μ—μ„œ μ‚¬μš©ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€), method facts, negative findings and standard legal or financial notices stay outside these rules.
21
+ - ko-status-negation also covers the μ“°μ§€ form, the ~μ§€ μ•ŠμŠ΅λ‹ˆλ‹€ and ~μ§€ μ•Šμ•˜μŠ΅λ‹ˆλ‹€ endings, and bold-wrapped endings. It stays a warning: a method fact such as μ‹€μ œ 운영 λ°μ΄ν„°λ‘œ κ²€μ¦ν•˜μ§€ μ•Šμ•˜μŠ΅λ‹ˆλ‹€ may be exactly what the reader needs, and a lone μ•„λ‹˜ or μ“°μ§€ μ•ŠμŒ sentence is judged by that warning rather than by the block rules above.
20
22
  - ko-plain-meta-label-warn and en-plain-caveat-label β€” warnings for boundary headings. They may be useful in internal or technical packets.
21
23
  - en-knowledge-cutoff, en-ai-self-disclaimer, en-hope-helps and ko-chatbot-signoff β€” block. Remove the model wrapper or generic sign-off, then retain the answer.
22
24
  - ko-chatbot-opener and en-chatbot-opener β€” block stock greetings and praise at the start of a deliverable.
@@ -185,7 +185,7 @@
185
185
  "id": "ko-status-negation",
186
186
  "lang": "ko",
187
187
  "severity": "warn",
188
- "pattern": "(?:검증|μ‹€μΈ‘|μΈ‘μ •|μ‹€ν–‰|μ‹€μ‹œ|μ‹œμž‘|확인|보μž₯|평가|νŒλ‹¨|μ‘°μ–Έ|의미|증λͺ…|μž¬ν˜„|μ‚¬μš©|제곡|적용|μ“°)(?:[λœν•œ]\\s*(?:적이|값이)?|ν•˜μ§€(?:\\s*μ•Š(?:음|λŠ”λ‹€|μ•˜λ‹€))?|λ˜μ§€\\s*μ•Š(?:음|λŠ”λ‹€|μ•˜λ‹€)|이|은|λŠ”)?\\s*(?:μ•„λ‹˜|μ•ŠμŒ|μ•ŠλŠ”λ‹€|μ•Šμ•˜λ‹€|μ—†μŒ)|보λ₯˜",
188
+ "pattern": "(?:검증|μ‹€μΈ‘|μΈ‘μ •|μ‹€ν–‰|μ‹€μ‹œ|μ‹œμž‘|확인|보μž₯|평가|νŒλ‹¨|μ‘°μ–Έ|의미|증λͺ…|μž¬ν˜„|μ‚¬μš©|제곡|적용|μ“°)(?:[λœν•œ](?:\\s*(?:적이|값이))?|ν•˜μ§€(?:\\s*μ•Š(?:음|λŠ”λ‹€|μ•˜λ‹€))?|λ˜μ§€\\s*μ•Š(?:음|λŠ”λ‹€|μ•˜λ‹€)|(?<=μ“°)μ§€|이|은|λŠ”)?\\s*(?:(?:\\*\\*|__)\\s*)?(?:μ•„λ‹˜|μ•ŠμŒ|μ•ŠλŠ”λ‹€|μ•Šμ•˜λ‹€|μ•ŠμŠ΅λ‹ˆλ‹€|μ•Šμ•˜μŠ΅λ‹ˆλ‹€|μ—†μŒ)|보λ₯˜",
189
189
  "flags": "im",
190
190
  "scope": "line",
191
191
  "context": [
@@ -879,6 +879,57 @@
879
879
  "en-chatbot-closer:positive",
880
880
  "en-chatbot-closer:negative"
881
881
  ]
882
+ },
883
+ {
884
+ "id": "ko-negative-pledge",
885
+ "lang": "ko",
886
+ "severity": "block",
887
+ "pattern": "(?<![κ°€-힣])(?:이|λ³Έ|ν•΄λ‹Ή|μœ„|μ•„λž˜)\\s+(?:자료|λ¬Έμ„œ|λ³΄κ³ μ„œ|μŠ¬λΌμ΄λ“œ|덱|ν‘œ|κ·Έλ¦Ό|κ·Έλž˜ν”„|차트|수치|κ²°κ³Ό|비ꡐ|뢄석|λ‚΄μš©|μ˜ˆμ‹œ)(?:은|λŠ”)\\s[^.!?\\n]{0,40}?(?:(?:ν•΄μ„ν•˜|μ˜λ―Έν•˜|μ£Όμž₯ν•˜|λŒ€ν‘œν•˜)(?:μ§€\\s*(?:[*_]{1,2}\\s*)?(?:μ•Š(?:음|λŠ”λ‹€|μŠ΅λ‹ˆλ‹€)|말\\s*것|λ§ˆμ„Έμš”|λ§ˆμ‹­μ‹œμ˜€)|(?:으)?λ©΄\\s*(?:[*_]{1,2}\\s*)?μ•ˆ\\s*(?:됨|λœλ‹€|λ©λ‹ˆλ‹€))|(?:(?:비ꡐ|κ²°λ‘ |벀치마크|μˆœμœ„|λŒ€ν‘œκ°’|μΌλ°˜ν™”)(?:이|κ°€)|λͺ©μ μ΄|μœ„ν•œ\\s*것이)\\s*(?:[*_]{1,2}\\s*)?(?:μ•„λ‹˜|μ•„λ‹ˆλ‹€|μ•„λ‹™λ‹ˆλ‹€)(?![κ°€-힣]))|(?:비ꡐ|κ²°λ‘ |벀치마크|μˆœμœ„|λŒ€ν‘œκ°’|μΌλ°˜ν™”)(?:으둜|둜)\\s*(?:[*_]{1,2}\\s*)?(?:μ“°|μ‚¬μš©ν•˜|ν•΄μ„ν•˜|읽|κ°„μ£Όν•˜|μΈμš©ν•˜)(?:μ§€\\s*(?:[*_]{1,2}\\s*)?(?:μ•Š(?:음|λŠ”λ‹€|μŠ΅λ‹ˆλ‹€)|말\\s*것|λ§ˆμ„Έμš”|λ§ˆμ‹­μ‹œμ˜€)|(?:으)?λ©΄\\s*(?:[*_]{1,2}\\s*)?μ•ˆ\\s*(?:됨|λœλ‹€|λ©λ‹ˆλ‹€))|(?:곡개|배포|λŒ€μ™Έ|μ™ΈλΆ€|홍보|λ°œν‘œ|보고|비ꡐ|인용|곡식)용\\s*(?:자료|λ¬Έμ„œ|수치|ν‘œ|κ·Έλž˜ν”„)(?:이|κ°€)\\s*(?:[*_]{1,2}\\s*)?(?:μ•„λ‹˜|μ•„λ‹ˆλ‹€|μ•„λ‹™λ‹ˆλ‹€)(?![κ°€-힣])",
888
+ "flags": "m",
889
+ "scope": "line",
890
+ "context": [
891
+ "fenced_code",
892
+ "quoted_user_text"
893
+ ],
894
+ "rationale": "A line that tells the reader what the document, table or number is not for does not belong in the deliverable; it goes in the chat reply, or it is rewritten as a fact about the data. Three shapes are refused: a self-reference topic (이/λ³Έ/ν•΄λ‹Ή/μœ„/μ•„λž˜ plus a document noun) followed by a negated claim verb or a claim noun plus μ•„λ‹˜ on the same line; a comparison, conclusion or ranking noun plus (으)둜 and a negated use verb; and a purpose-용 data noun such as 곡개용 수치 plus μ•„λ‹˜. Use verbs after a self-reference, κ·Όκ±°/평가/증거/μΆ”μ²œ, and the legal or financial notice verbs (λŒ€μ²΄ν•˜, 보μž₯ν•˜, ꢌ유) stay outside the pattern, because operating rules, method lines and standard notices are written with them.",
895
+ "fixture_ids": [
896
+ "ko-negative-pledge:positive",
897
+ "ko-negative-pledge:negative"
898
+ ]
899
+ },
900
+ {
901
+ "id": "ko-negative-pledge-repeat",
902
+ "lang": "ko",
903
+ "severity": "block",
904
+ "pattern": "(?:(?:ν•΄μ„ν•˜|μ£Όμž₯ν•˜|λŒ€ν‘œν•˜)μ§€\\s*(?:[*_]{1,2}\\s*)?μ•Š(?:음|μŠ΅λ‹ˆλ‹€)|(?:비ꡐ|κ²°λ‘ |벀치마크|μˆœμœ„|λŒ€ν‘œκ°’|μΌλ°˜ν™”)(?:이|κ°€)\\s*(?:[*_]{1,2}\\s*)?(?:μ•„λ‹˜|μ•„λ‹™λ‹ˆλ‹€)(?![κ°€-힣]))(?:[*_]{1,2})?(?=\\s*(?:[.!?。]|$))[\\s\\S]*?(?:(?:ν•΄μ„ν•˜|μ£Όμž₯ν•˜|λŒ€ν‘œν•˜)μ§€\\s*(?:[*_]{1,2}\\s*)?μ•Š(?:음|μŠ΅λ‹ˆλ‹€)|(?:비ꡐ|κ²°λ‘ |벀치마크|μˆœμœ„|λŒ€ν‘œκ°’|μΌλ°˜ν™”)(?:이|κ°€)\\s*(?:[*_]{1,2}\\s*)?(?:μ•„λ‹˜|μ•„λ‹™λ‹ˆλ‹€)(?![κ°€-힣]))(?:[*_]{1,2})?(?=\\s*(?:[.!?。]|$))",
905
+ "flags": "m",
906
+ "scope": "document",
907
+ "context": [
908
+ "fenced_code",
909
+ "quoted_user_text"
910
+ ],
911
+ "rationale": "Two or more sentences that end in ν•΄μ„ν•˜μ§€/μ£Όμž₯ν•˜μ§€/λŒ€ν‘œν•˜μ§€ μ•ŠμŒ, or in a claim noun plus 이/κ°€ plus μ•„λ‹˜, turn a document into a list of disclaimers. μ˜λ―Έν•˜, κ°„μ£Όν•˜, μΈμš©ν•˜ and the use verbs are left out because repeated definitions, data-handling rules and operating rules end the same way. A single such sentence is left to the advisory ko-status-negation rule.",
912
+ "fixture_ids": [
913
+ "ko-negative-pledge-repeat:positive",
914
+ "ko-negative-pledge-repeat:negative"
915
+ ]
916
+ },
917
+ {
918
+ "id": "en-negative-pledge",
919
+ "lang": "en",
920
+ "severity": "block",
921
+ "pattern": "\\b(?:this|these)\\s+(?:deck|report|document|analysis|table|chart|figure|figures|numbers|results|slide|comparison)\\s+(?:(?:is|are)\\s+not\\s+(?:intended|meant|to\\s+be\\s+(?:read|used|taken|interpreted))(?:\\s+to\\s+be\\s+(?:read|used|taken|interpreted))?\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|(?:should|must)\\s+not\\s+be\\s+(?:read|used|taken|interpreted)\\s+as\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b)|\\b(?:this|these)\\s+(?:is|are)\\s+not\\s+(?:intended|meant)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\bthe\\s+(?:deck|report|document|analysis)\\s+makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b|(?:^|\\s[-*]\\s)\\s*(?:[-*]\\s+|\\d+\\.\\s+)?(?:[*_]{1,2})?not\\s+(?:intended|meant|to\\s+be\\s+read|to\\s+be\\s+used)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\b(?:this|these)\\s+(?:table|chart|figure|figures|numbers|results|comparison|analysis)\\s+(?:does|do)\\s+not\\s+constitute\\s+(?:an?\\s+)?[^.!?]{0,60}?\\b(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)",
922
+ "flags": "i",
923
+ "scope": "sentence",
924
+ "context": [
925
+ "fenced_code",
926
+ "quoted_user_text"
927
+ ],
928
+ "rationale": "A sentence saying the deck, report or numbers are not intended, meant or to be read as a comparison, benchmark or ranking, that a table or set of figures does not constitute one, or that a document makes no claim about something, belongs in the chat reply. The comparison, benchmark or ranking noun is required so safety labels and advice, offer or diagnosis notices stay clean; \"does not constitute\" is limited to table-like subjects, and \"the\" opens a refusable sentence only with \"makes no claim\".",
929
+ "fixture_ids": [
930
+ "en-negative-pledge:positive",
931
+ "en-negative-pledge:negative"
932
+ ]
882
933
  }
883
934
  ]
884
935
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litfamily/litcodex",
3
- "version": "1.0.23",
3
+ "version": "1.0.24",
4
4
  "description": "Codex CLI plugin that turns a request into a goal with checks, keeps the evidence in your project and hands unfinished work to the next session.",
5
5
  "keywords": [
6
6
  "codex",
@@ -52,7 +52,7 @@
52
52
  "readme-assets"
53
53
  ],
54
54
  "dependencies": {
55
- "@litcodex/lit-loop": "1.0.23"
55
+ "@litcodex/lit-loop": "1.0.24"
56
56
  },
57
57
  "bundledDependencies": [
58
58
  "@litcodex/lit-loop"
@@ -1 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.23"><title>release: 1.0.23</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.23</text></g></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.24"><title>release: 1.0.24</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.24</text></g></svg>