@litfamily/litcodex 1.0.3 โ†’ 1.0.5

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 (88) hide show
  1. package/README.md +115 -77
  2. package/dist/cli-model-route.js +27 -27
  3. package/dist/cli.js +6 -4
  4. package/dist/config-migration/catalog.d.ts +40 -1
  5. package/dist/config-migration/catalog.js +202 -57
  6. package/dist/config-migration/cli.d.ts +2 -1
  7. package/dist/config-migration/cli.js +34 -32
  8. package/dist/config-migration/gpt56-policy.d.ts +19 -10
  9. package/dist/config-migration/gpt56-policy.js +92 -50
  10. package/dist/config-migration/index.d.ts +2 -0
  11. package/dist/config-migration/index.js +28 -10
  12. package/dist/install/doctor-config.js +5 -5
  13. package/dist/install/doctor-render.js +16 -16
  14. package/dist/install/doctor.js +2 -2
  15. package/dist/install/execute.js +5 -4
  16. package/dist/install/generated-skill-payload-hashes.d.ts +30 -3
  17. package/dist/install/generated-skill-payload-hashes.js +30 -3
  18. package/dist/install/host-capabilities.d.ts +3 -4
  19. package/dist/install/host-capabilities.js +17 -19
  20. package/dist/install/install-model-prompt.js +44 -26
  21. package/dist/install/install-options.js +41 -46
  22. package/dist/install/install-presentation.js +2 -1
  23. package/dist/install/skill-catalog.d.ts +1 -1
  24. package/dist/install/skill-catalog.js +6 -1
  25. package/dist/install/skill-resource-hashes.d.ts +1 -1
  26. package/dist/install/skill-resource-hashes.js +1 -1
  27. package/dist/install/uninstall.js +6 -7
  28. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  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/agents/litcodex-default.toml +1 -1
  33. package/marketplace/plugins/litcodex/components/lit-loop/agents/litcodex-explorer.toml +1 -1
  34. package/marketplace/plugins/litcodex/components/lit-loop/agents/litcodex-librarian.toml +1 -1
  35. package/marketplace/plugins/litcodex/components/lit-loop/agents/litcodex-metis.toml +1 -1
  36. package/marketplace/plugins/litcodex/components/lit-loop/directives/litwork.md +1 -1
  37. package/marketplace/plugins/litcodex/components/lit-loop/dist/lit-mark.d.ts +2 -2
  38. package/marketplace/plugins/litcodex/components/lit-loop/dist/lit-mark.js +4 -44
  39. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  40. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  41. package/marketplace/plugins/litcodex/components/rules/dist/model-metadata.d.ts +2 -1
  42. package/marketplace/plugins/litcodex/components/rules/dist/model-metadata.js +9 -1
  43. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  44. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  45. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  46. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  47. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/SKILL.md +22 -19
  48. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/canonical-library.md +7 -1
  49. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/complete-contract.md +17 -11
  50. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/default-editorial-pixel.json +64 -0
  51. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/references/production-interview.md +25 -0
  52. package/marketplace/plugins/litcodex/skills/readme-studio/SKILL.md +94 -0
  53. package/marketplace/plugins/litcodex/skills/readme-studio/references/decoration-patterns.md +36 -0
  54. package/marketplace/plugins/litcodex/skills/readme-studio/references/facts-and-assembly.md +36 -0
  55. package/marketplace/plugins/litcodex/skills/readme-studio/references/motion-and-delivery.md +47 -0
  56. package/marketplace/plugins/litcodex/skills/readme-studio/references/typography-and-imagery.md +34 -0
  57. package/marketplace/plugins/litcodex/skills/readme-studio/scripts/validate-readme-facts.mjs +130 -0
  58. package/marketplace/plugins/litcodex/skills/readme-studio/templates/cover-source.json +35 -0
  59. package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/index.html +61 -0
  60. package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/index.motion.json +6 -0
  61. package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/package-lock.json +1969 -0
  62. package/marketplace/plugins/litcodex/skills/readme-studio/templates/hyperframes-cover/package.json +14 -0
  63. package/marketplace/plugins/litcodex/skills/readme-studio/templates/readme-cover-section.md +85 -0
  64. package/marketplace/plugins/litcodex/skills/readme-studio/templates/readme-facts.json +11 -0
  65. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/package-lock.json +3783 -0
  66. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/package.json +15 -0
  67. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/src/ReadmeCover.tsx +102 -0
  68. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/src/Root.tsx +48 -0
  69. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/src/index.tsx +4 -0
  70. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/src/layout.ts +35 -0
  71. package/marketplace/plugins/litcodex/skills/readme-studio/templates/remotion-cover/src/motion.ts +25 -0
  72. package/marketplace/plugins/litcodex/skills/readme-studio/templates/typography/package-lock.json +133 -0
  73. package/marketplace/plugins/litcodex/skills/readme-studio/templates/typography/package.json +8 -0
  74. package/marketplace/plugins/litcodex/skills/readme-studio/templates/typography/shape-text-to-svg.mjs +238 -0
  75. package/model-catalog.json +163 -4
  76. package/node_modules/@litcodex/lit-loop/agents/litcodex-default.toml +1 -1
  77. package/node_modules/@litcodex/lit-loop/agents/litcodex-explorer.toml +1 -1
  78. package/node_modules/@litcodex/lit-loop/agents/litcodex-librarian.toml +1 -1
  79. package/node_modules/@litcodex/lit-loop/agents/litcodex-metis.toml +1 -1
  80. package/node_modules/@litcodex/lit-loop/directives/litwork.md +1 -1
  81. package/node_modules/@litcodex/lit-loop/dist/lit-mark.d.ts +2 -2
  82. package/node_modules/@litcodex/lit-loop/dist/lit-mark.js +4 -44
  83. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  84. package/package.json +2 -2
  85. package/readme-assets/badge-version.svg +1 -1
  86. package/readme-assets/cover-motion-still.webp +0 -0
  87. package/readme-assets/cover-motion.webp +0 -0
  88. package/readme-assets/litfamily-machines.png +0 -0
@@ -1,32 +1,50 @@
1
- // Installer model/effort prompts per the LitFamily installer choice contract
2
- // (plans/references/installer-choice-contract.md, 2026-08-29). LitCodex offers the OpenAI GPT-5.6
3
- // family only; every menu row is a supported model+effort pair, so a forbidden pair (luna+xhigh)
4
- // is never listed. Numbered readline menus, zero-based, default in brackets, no TUI library.
1
+ // Installer model/effort prompts per the LitFamily installer choice contract.
2
+ // Model metadata and supported effort validation come from model-catalog.json through catalog.ts.
3
+ // Numbered readline menus, zero-based, default in brackets, no TUI library.
4
+ import { FALLBACK_CATALOG } from "../config-migration/catalog.js";
5
5
  import { dim } from "../ui-style.js";
6
6
  import { InstallError } from "./errors.js";
7
- export const LEAD_MENU_ROWS = [
8
- { model: "gpt-6-astra", profile: "astra", effort: "xhigh", note: "โ€” deepest reasoning, recommended lead" },
9
- { model: "gpt-6-astra", profile: "astra", effort: "low", note: "โ€” lower latency" },
10
- { model: "gpt-6-astra", profile: "astra", effort: "medium", note: "" },
11
- { model: "gpt-6-astra", profile: "astra", effort: "high", note: "" },
12
- { model: "gpt-6-astra", profile: "astra", effort: "max", note: "" },
13
- { model: "gpt-5.6-sol", profile: "sol", effort: "xhigh", note: "โ€” deepest reasoning, slowest (recommended lead)" },
14
- { model: "gpt-5.6-luna", profile: "luna", effort: "max", note: "โ€” balanced (recommended helper)" },
15
- { model: "gpt-5.6-sol", profile: "sol", effort: "high", note: "โ€” same model, faster" },
16
- { model: "gpt-5.6-terra", profile: "terra", effort: "xhigh", note: "" },
17
- ];
18
- export const HELPER_MENU_ROWS = [
19
- { model: "gpt-5.6-luna", profile: "luna", effort: "max", note: "โ€” balanced (recommended helper)" },
20
- { model: "gpt-6-astra", profile: "astra", effort: "low", note: "โ€” explicit Astra helper" },
21
- { model: "gpt-6-astra", profile: "astra", effort: "medium", note: "" },
22
- { model: "gpt-6-astra", profile: "astra", effort: "high", note: "" },
23
- { model: "gpt-6-astra", profile: "astra", effort: "xhigh", note: "" },
24
- { model: "gpt-6-astra", profile: "astra", effort: "max", note: "" },
25
- { model: "gpt-5.6-sol", profile: "sol", effort: "high", note: "โ€” same model, faster" },
26
- { model: "gpt-5.6-terra", profile: "terra", effort: "xhigh", note: "" },
27
- ];
7
+ function menuRows(role) {
8
+ const preferredModel = role === "lead" ? FALLBACK_CATALOG.current.model : FALLBACK_CATALOG.roles["default"]?.model;
9
+ const orderedModels = [...FALLBACK_CATALOG.models].sort((left, right) => {
10
+ if (left.id === preferredModel)
11
+ return -1;
12
+ if (right.id === preferredModel)
13
+ return 1;
14
+ return left.priority - right.priority;
15
+ });
16
+ return orderedModels.flatMap((definition) => definition.installerMenu[role].map((effort) => catalogRow(definition, effort, role)));
17
+ }
18
+ function catalogRow(definition, effort, role) {
19
+ if (!definition.configurableEfforts.includes(effort)) {
20
+ throw new Error(`Invalid installer menu route: ${definition.id} ยท ${effort}`);
21
+ }
22
+ return {
23
+ model: definition.id,
24
+ profile: definition.configProfile,
25
+ effort,
26
+ note: menuNote(definition, effort, role),
27
+ };
28
+ }
29
+ function menuNote(definition, effort, role) {
30
+ if (effort !== definition.recommendedEffort)
31
+ return "";
32
+ if (definition.recommendedRole === "lead")
33
+ return "โ€” recommended lead";
34
+ if (definition.recommendedRole === "coding-lead")
35
+ return "โ€” coding-lead alternative";
36
+ if (definition.recommendedRole === "helper") {
37
+ return role === "lead" ? "โ€” recommended helper route" : "โ€” recommended helper";
38
+ }
39
+ if (definition.recommendedRole === "previous-generation") {
40
+ return `โ€” previous-generation ${definition.displayName.replace(/^GPT-5\.6\s*/i, "")}`;
41
+ }
42
+ return "";
43
+ }
44
+ export const LEAD_MENU_ROWS = menuRows("lead");
45
+ export const HELPER_MENU_ROWS = menuRows("helper");
28
46
  function menuLine(index, row) {
29
- return ` ${String(index)}. ${row.model.padEnd(13)} ยท ${row.effort.padEnd(8)}${row.note}`.replace(/\s+$/, "");
47
+ return ` ${String(index).padStart(2)}. ${row.model.padEnd(13)} ยท ${row.effort.padEnd(8)}${row.note}`.replace(/\s+$/, "");
30
48
  }
31
49
  export function renderLeadModelMenu() {
32
50
  return ["Choose the LEAD model (plans and reviews).", ...LEAD_MENU_ROWS.map((row, i) => menuLine(i, row))].join("\n");
@@ -1,3 +1,4 @@
1
+ import { acceptedModelIds, canonicalModelId, FALLBACK_CATALOG, modelDefinition, } from "../config-migration/catalog.js";
1
2
  import { unsafeEffectiveRoute } from "../config-migration/gpt56-policy.js";
2
3
  import { resolveCodexHome } from "./codex.js";
3
4
  import { InstallError } from "./errors.js";
@@ -19,21 +20,6 @@ const KNOWN_FLAGS = new Set([
19
20
  "--no-auto-update",
20
21
  "--managed-upgrade",
21
22
  ]);
22
- const LEAD_MODEL_CHOICES = {
23
- "gpt-6-astra": { id: "gpt-6-astra", profile: "astra", defaultEffort: "xhigh" },
24
- astra: { id: "gpt-6-astra", profile: "astra", defaultEffort: "xhigh" },
25
- sol: { id: "gpt-5.6-sol", profile: "sol", defaultEffort: "xhigh" },
26
- "gpt-5.6": { id: "gpt-5.6", profile: "sol", defaultEffort: "high" },
27
- luna: { id: "gpt-5.6-luna", profile: "luna", defaultEffort: "max" },
28
- terra: { id: "gpt-5.6-terra", profile: "terra", defaultEffort: "xhigh" },
29
- };
30
- const HELPER_MODEL_CHOICES = {
31
- "gpt-6-astra": { id: "gpt-6-astra", profile: "astra", defaultEffort: "xhigh" },
32
- astra: { id: "gpt-6-astra", profile: "astra", defaultEffort: "xhigh" },
33
- luna: { id: "gpt-5.6-luna", profile: "luna", defaultEffort: "max" },
34
- "gpt-5.6": { id: "gpt-5.6", profile: "sol", defaultEffort: "high" },
35
- terra: { id: "gpt-5.6-terra", profile: "terra", defaultEffort: "xhigh" },
36
- };
37
23
  export const OUTPUT_STYLE_IDS = ["off", "asd-ste100", "asd-ste100-ko", "eli5", "eli5-ko"];
38
24
  export function parseInstallOptions(args, context) {
39
25
  const valueIndexes = new Set(["--repo", "--model", "--effort", "--subagent-model", "--subagent-effort", "--style"]
@@ -76,27 +62,43 @@ export function hasExplicitModelRouteFlags(args) {
76
62
  }
77
63
  function modelChoice(args) {
78
64
  const index = args.indexOf("--model");
79
- const fallback = LEAD_MODEL_CHOICES["gpt-6-astra"];
80
- if (index === -1)
81
- return fallback;
82
- const value = args[index + 1];
83
- const choice = value === undefined ? undefined : LEAD_MODEL_CHOICES[value];
84
- if (choice === undefined) {
85
- throw badFlag("--model requires one of: gpt-6-astra, sol, gpt-5.6, luna, terra", "--model");
65
+ if (index === -1) {
66
+ return choiceForModel(FALLBACK_CATALOG.current.model, "", FALLBACK_CATALOG.current.model_reasoning_effort);
86
67
  }
87
- return choice;
68
+ const value = args[index + 1];
69
+ if (value === undefined)
70
+ throw badFlag(`--model requires one of: ${acceptedModelIds().join(", ")}`, "--model");
71
+ return choiceForModel(value, "--model");
88
72
  }
89
73
  function subagentModelChoice(args) {
90
74
  const index = args.indexOf("--subagent-model");
91
- const fallback = HELPER_MODEL_CHOICES["luna"];
92
- if (index === -1)
93
- return fallback;
75
+ if (index === -1) {
76
+ const route = FALLBACK_CATALOG.roles["default"];
77
+ if (route?.model === undefined || route.model_reasoning_effort === undefined) {
78
+ throw new Error("The bundled model catalog has no default helper route.");
79
+ }
80
+ return choiceForModel(route.model, "", route.model_reasoning_effort);
81
+ }
94
82
  const value = args[index + 1];
95
- const choice = value === undefined ? undefined : HELPER_MODEL_CHOICES[value];
96
- if (choice === undefined) {
97
- throw badFlag("--subagent-model requires one of: gpt-6-astra, luna, gpt-5.6, terra", "--subagent-model");
83
+ if (value === undefined) {
84
+ throw badFlag(`--subagent-model requires one of: ${acceptedModelIds().join(", ")}`, "--subagent-model");
98
85
  }
99
- return choice;
86
+ return choiceForModel(value, "--subagent-model");
87
+ }
88
+ function choiceForModel(value, flag = "", defaultEffort) {
89
+ const id = canonicalModelId(value);
90
+ const definition = modelDefinition(value);
91
+ if (id === undefined || definition === undefined) {
92
+ if (flag !== "")
93
+ throw badFlag(`${flag} requires one of: ${acceptedModelIds().join(", ")}`, flag);
94
+ throw new Error(`Unknown bundled model ${value}`);
95
+ }
96
+ return {
97
+ id,
98
+ profile: definition.configProfile,
99
+ defaultEffort: defaultEffort ?? definition.recommendedEffort,
100
+ definition,
101
+ };
100
102
  }
101
103
  function effortChoice(args, lead) {
102
104
  return pairedEffort(args, "--effort", lead);
@@ -110,18 +112,10 @@ function pairedEffort(args, flag, model) {
110
112
  let effort = model.defaultEffort;
111
113
  if (index !== -1) {
112
114
  const value = args[index + 1];
113
- if (model.profile === "astra") {
114
- if (!isAstraEffort(value)) {
115
- throw badFlag(`${flag} requires one of: low, medium, high, xhigh, max`, flag);
116
- }
117
- effort = value;
118
- }
119
- else if (!isGpt56Effort(value)) {
120
- throw badFlag(`${flag} requires one of: high, xhigh, max`, flag);
121
- }
122
- else {
123
- effort = value;
115
+ if (!model.definition.configurableEfforts.includes(value)) {
116
+ throw badFlag(`${flag} for ${model.id} requires one of: ${formatEfforts(model.definition.configurableEfforts)}`, flag);
124
117
  }
118
+ effort = value;
125
119
  }
126
120
  const unsafe = unsafeEffectiveRoute({ model: model.id, model_reasoning_effort: effort });
127
121
  if (unsafe !== null) {
@@ -129,11 +123,12 @@ function pairedEffort(args, flag, model) {
129
123
  }
130
124
  return effort;
131
125
  }
132
- function isAstraEffort(value) {
133
- return value === "low" || value === "medium" || value === "high" || value === "xhigh" || value === "max";
134
- }
135
- function isGpt56Effort(value) {
136
- return value === "high" || value === "xhigh" || value === "max";
126
+ function formatEfforts(efforts) {
127
+ if (efforts.length < 2)
128
+ return efforts.join("");
129
+ if (efforts.length === 2)
130
+ return `${efforts[0]} or ${efforts[1]}`;
131
+ return `${efforts.slice(0, -1).join(", ")}, or ${efforts.at(-1)}`;
137
132
  }
138
133
  function styleChoice(args) {
139
134
  const index = args.indexOf("--style");
@@ -1,3 +1,4 @@
1
+ import { EXPLICIT_GPT56_SOL_MODEL, GPT56_MODELS } from "../config-migration/gpt56-policy.js";
1
2
  import { amber, bold, dim, green, orange, red } from "../ui-style.js";
2
3
  import { routingReport } from "./agent-routing.js";
3
4
  const STEP_PRESENTATION = {
@@ -53,7 +54,7 @@ export function renderInstallReceipt(result, opts) {
53
54
  const concurrency = result.capabilities?.concurrency;
54
55
  const compaction = result.capabilities?.autoCompaction;
55
56
  const contexts = result.capabilities?.modelContexts;
56
- const context = contexts?.[model === "gpt-5.6-sol" ? "gpt-5.6" : model] ?? null;
57
+ const context = contexts?.[model === EXPLICIT_GPT56_SOL_MODEL ? GPT56_MODELS.sol : model] ?? null;
57
58
  const counts = summarizeSteps(result.steps);
58
59
  const lines = [
59
60
  "",
@@ -6,7 +6,7 @@ import type { ReadonlyFsLike } from "./codex.js";
6
6
  * marketplace has every supported skill entry point, while the companion test
7
7
  * compares it with the repository's package contract.
8
8
  */
9
- export declare const CANONICAL_SKILL_IDS: readonly ["autoconference", "autoresearch", "browser-drive", "coding-session-audit", "comment-checker", "debugging", "deep-interview", "frontend-ui-ux", "lit-burnoff", "lit-burnoff-file", "lit-code", "lit-commit", "lit-comprehend", "lit-crucible", "lit-fetch", "lit-handoff", "lit-init", "lit-korean", "lit-loop", "lit-plan", "lit-recap", "lit-scientific-visualization", "lit-team", "litcodex-contribute-bug-fix", "litcodex-doctor", "litcodex-report-bug", "litgoal", "litresearch", "litwork", "lsp", "lsp-setup", "refactor", "review-work", "rules", "start-work", "structural-search", "visual-qa", "wikify"];
9
+ export declare const CANONICAL_SKILL_IDS: readonly ["autoconference", "autoresearch", "browser-drive", "coding-session-audit", "comment-checker", "debugging", "deep-interview", "frontend-ui-ux", "lit-burnoff", "lit-burnoff-file", "lit-code", "lit-commit", "lit-comprehend", "lit-crucible", "lit-fetch", "lit-handoff", "lit-init", "lit-korean", "lit-loop", "lit-plan", "lit-recap", "lit-scientific-visualization", "lit-team", "litcodex-contribute-bug-fix", "litcodex-doctor", "litcodex-report-bug", "litgoal", "litresearch", "litwork", "lsp", "lsp-setup", "readme-studio", "refactor", "review-work", "rules", "start-work", "structural-search", "visual-qa", "wikify"];
10
10
  export declare const CANONICAL_SKILL_RESOURCE_PATHS: readonly ["lsp/references/runtime-triage.md", ...string[]];
11
11
  export interface SkillCatalogPayloadReport {
12
12
  readonly complete: boolean;
@@ -1,6 +1,6 @@
1
1
  import { join } from "node:path";
2
2
  import { payloadExact } from "./bundled-skills.js";
3
- import { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./skill-resource-hashes.js";
3
+ import { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, README_STUDIO_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./skill-resource-hashes.js";
4
4
  /**
5
5
  * The Codex-native skill directories shipped in the LitCodex marketplace payload.
6
6
  *
@@ -40,6 +40,7 @@ export const CANONICAL_SKILL_IDS = [
40
40
  "litwork",
41
41
  "lsp",
42
42
  "lsp-setup",
43
+ "readme-studio",
43
44
  "refactor",
44
45
  "review-work",
45
46
  "rules",
@@ -65,6 +66,9 @@ export const CANONICAL_SKILL_RESOURCE_PATHS = [
65
66
  ...Object.keys(FRONTEND_UIUX_PAYLOAD_HASHES)
66
67
  .filter((path) => path !== "SKILL.md")
67
68
  .map((path) => `frontend-ui-ux/${path}`),
69
+ ...Object.keys(README_STUDIO_PAYLOAD_HASHES)
70
+ .filter((path) => path !== "SKILL.md")
71
+ .map((path) => `readme-studio/${path}`),
68
72
  ...Object.keys(VISUAL_QA_PAYLOAD_HASHES)
69
73
  .filter((path) => path !== "SKILL.md")
70
74
  .map((path) => `visual-qa/${path}`),
@@ -89,6 +93,7 @@ export function probeSkillCatalogPayload(fs, marketplaceRoot) {
89
93
  ["browser-drive", BROWSER_DRIVE_PAYLOAD_HASHES],
90
94
  ["deep-interview", DEEP_INTERVIEW_PAYLOAD_HASHES],
91
95
  ["frontend-ui-ux", FRONTEND_UIUX_PAYLOAD_HASHES],
96
+ ["readme-studio", README_STUDIO_PAYLOAD_HASHES],
92
97
  ["visual-qa", VISUAL_QA_PAYLOAD_HASHES],
93
98
  ["structural-search", STRUCTURAL_SEARCH_PAYLOAD_HASHES],
94
99
  ["coding-session-audit", CODING_SESSION_AUDIT_PAYLOAD_HASHES],
@@ -1 +1 @@
1
- export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
1
+ export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, README_STUDIO_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
@@ -1 +1 @@
1
- export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
1
+ export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, README_STUDIO_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
@@ -1,6 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { lstatSync as nativeLstatSync } from "node:fs";
3
3
  import { join } from "node:path";
4
+ import { acceptedModelIds, modelDefinition } from "../config-migration/catalog.js";
5
+ import { unsafeEffectiveRoute } from "../config-migration/gpt56-policy.js";
4
6
  import { removeSubagentDefaults } from "../config-migration/multi-agent-v2-guard.js";
5
7
  import { ensureNativeDefaultAgentConfig } from "../config-migration/native-default-route.js";
6
8
  import { GPT56_PROFILE_FILE_NAMES, isManagedGpt56ProfileContent } from "../config-migration/profile-files.js";
@@ -143,13 +145,10 @@ const MANAGED_DEFAULT_HEADER = [
143
145
  'nickname_candidates = ["Worker"]',
144
146
  ];
145
147
  const MANAGED_DEFAULT_BODY_SHA256 = "896348bda14e53d96e54edfe3d2d01199810c1a18523c52b03a897a0596934e7";
146
- const MANAGED_DEFAULT_EFFORTS = {
147
- "gpt-5.6": ["high", "xhigh", "max"],
148
- "gpt-5.6-sol": ["high", "xhigh", "max"],
149
- "gpt-5.6-luna": ["high", "max"],
150
- "gpt-5.6-terra": ["high", "xhigh"],
151
- "gpt-6-astra": ["low", "medium", "high", "xhigh", "max"],
152
- };
148
+ const MANAGED_DEFAULT_EFFORTS = Object.fromEntries(acceptedModelIds().map((model) => [
149
+ model,
150
+ (modelDefinition(model)?.configurableEfforts ?? []).filter((effort) => unsafeEffectiveRoute({ model, model_reasoning_effort: effort }) === null),
151
+ ]));
153
152
  function isManagedNativeDefault(deps, path) {
154
153
  if (!deps.fs.existsSync(path) || !isRegularNonSymlink(deps, path) || deps.fs.readFileSync === undefined) {
155
154
  return false;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litcodex",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
4
4
  "description": "LitCodex Codex plugin: the lit-loop activation, durable loop runtime, and local review-gated knowledge.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/auto-update",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
4
4
  "description": "LitCodex foreground update barrier for the SessionStart and management lifecycles.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/comment-checker",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
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.3",
3
+ "version": "1.0.5",
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,7 +1,7 @@
1
1
  name = "default"
2
2
  description = "General-purpose LitCodex helper route for omitted-agent dispatch."
3
3
  nickname_candidates = ["Worker"]
4
- model = "gpt-5.6-luna"
4
+ model = "gpt-6-luna"
5
5
  model_reasoning_effort = "max"
6
6
 
7
7
  developer_instructions = """
@@ -1,7 +1,7 @@
1
1
  name = "litcodex-explorer"
2
2
  description = "Codebase search specialist for Codex sessions. Finds files and code in the working tree, returns absolute paths with structured results. Read-only."
3
3
  nickname_candidates = ["Explorer"]
4
- model = "gpt-5.6-luna"
4
+ model = "gpt-6-luna"
5
5
  model_reasoning_effort = "max"
6
6
 
7
7
  developer_instructions = """
@@ -1,7 +1,7 @@
1
1
  name = "litcodex-librarian"
2
2
  description = "External open-source codebase and documentation researcher. Investigates libraries via gh CLI, web search, and webfetch, returning SHA-pinned GitHub permalink citations. Read-only."
3
3
  nickname_candidates = ["Librarian"]
4
- model = "gpt-5.6-luna"
4
+ model = "gpt-6-luna"
5
5
  model_reasoning_effort = "max"
6
6
 
7
7
  developer_instructions = """
@@ -1,7 +1,7 @@
1
1
  name = "litcodex-metis"
2
2
  description = "Pre-planning analyst. Detects contradictions, ambiguity, missing constraints, and execution risks in a draft plan or request before the planner commits. Read-only."
3
3
  nickname_candidates = ["Analyst"]
4
- model = "gpt-5.6-luna"
4
+ model = "gpt-6-luna"
5
5
  model_reasoning_effort = "max"
6
6
 
7
7
  developer_instructions = """
@@ -377,7 +377,7 @@ Keep the native route evidence-bound. The verified current Codex host resolves
377
377
  an installed role-only `agent_type` through its role TOML, including that role's
378
378
  model and reasoning effort, and resolves an omitted-agent child through
379
379
  `[agents.default].config_file`. The installer supplies that binding to the
380
- model-only Luna/max generic role at `<CODEX_HOME>/litcodex-default.toml`, outside
380
+ model-only GPT-6 Luna/max generic role at `<CODEX_HOME>/litcodex-default.toml`, outside
381
381
  the autodiscovered `<CODEX_HOME>/agents/` directory, and leaves the six named
382
382
  roles under that directory with the named Astra planning and review roles explicit.
383
383
  An explicitly selected helper model/effort
@@ -5,8 +5,8 @@ export type ColorMode = "truecolor" | "256" | "none";
5
5
  /** The standard mark in a 28-column field, with an arbitrary product label alongside. */
6
6
  export declare function lockup(productName: string): string[];
7
7
  export declare function supportsBlocks(env: NodeJS.ProcessEnv): boolean;
8
- /** Pipe-safe UserPromptSubmit mark; model-facing additionalContext remains plain text. */
9
- export declare function activationMessage(discipline: string, env?: NodeJS.ProcessEnv): string;
8
+ /** Pipe-safe and model-safe; Codex >=0.156 renders hook systemMessage control characters literally. */
9
+ export declare function activationMessage(discipline: string, _env?: NodeJS.ProcessEnv): string;
10
10
  export declare function colorMode(opts: {
11
11
  readonly isTty: boolean;
12
12
  readonly env: NodeJS.ProcessEnv;
@@ -90,54 +90,14 @@ export function supportsBlocks(env) {
90
90
  const locale = env["LC_ALL"] || env["LC_CTYPE"] || env["LANG"];
91
91
  return env["TERM"] !== "dumb" && (!locale || /utf-?8/i.test(locale));
92
92
  }
93
- const ACTIVATION_GRADIENT = [
94
- [255, 99, 55],
95
- [255, 45, 149],
96
- [0, 229, 255],
97
- ];
98
93
  const ACTIVATION_MARK_WIDTH = 12;
99
- function activationColoursEnabled(env) {
100
- // UserPromptSubmit stdout is always piped, so this deliberately does not inspect a TTY.
101
- return !Object.hasOwn(env, "NO_COLOR") && !Object.hasOwn(env, "CI") && supportsBlocks(env);
102
- }
103
- function interpolateActivation(stops, progress) {
104
- const segment = Math.min(stops.length - 2, Math.floor(progress * (stops.length - 1)));
105
- const fraction = progress * (stops.length - 1) - segment;
106
- const start = stops[segment];
107
- const end = stops[segment + 1];
108
- if (!start || !end)
109
- throw new Error("activation gradient requires at least two stops");
110
- return [
111
- Math.round(start[0] + (end[0] - start[0]) * fraction),
112
- Math.round(start[1] + (end[1] - start[1]) * fraction),
113
- Math.round(start[2] + (end[2] - start[2]) * fraction),
114
- ];
115
- }
116
- function paintActivation(text, enabled) {
117
- if (!enabled)
118
- return text;
119
- const chars = [...text];
120
- const last = chars.length - 1;
121
- const painted = chars
122
- .map((character, index) => {
123
- if (character === " ")
124
- return character;
125
- const [red, green, blue] = interpolateActivation(ACTIVATION_GRADIENT, last === 0 ? 0 : index / last);
126
- return `\x1b[38;2;${red};${green};${blue}m${character}`;
127
- })
128
- .join("");
129
- return `\x1b[1m${painted}\x1b[0m`;
130
- }
131
- /** Pipe-safe UserPromptSubmit mark; model-facing additionalContext remains plain text. */
132
- export function activationMessage(discipline, env = process.env) {
133
- const enabled = activationColoursEnabled(env);
94
+ /** Pipe-safe and model-safe; Codex >=0.156 renders hook systemMessage control characters literally. */
95
+ export function activationMessage(discipline, _env = process.env) {
134
96
  const rows = micro.map((row) => row.trimEnd());
135
97
  const width = Math.max(ACTIVATION_MARK_WIDTH, ...rows.map((row) => [...row].length));
136
98
  const paddedRows = rows.map((row) => row.padEnd(width));
137
- const label = `๐Ÿ”ฅ ${paintActivation(`LIT IGNITED ยท ${discipline}`, enabled)} ๐Ÿ”ฅ`;
138
- return `\n${paddedRows
139
- .map((row, index) => `${paintActivation(row, enabled)}${index === 2 ? ` ${label}` : ""}`)
140
- .join("\n")}`;
99
+ const label = `๐Ÿ”ฅ LIT IGNITED ยท ${discipline} ๐Ÿ”ฅ`;
100
+ return `\n${paddedRows.map((row, index) => `${row}${index === 2 ? ` ${label}` : ""}`).join("\n")}`;
141
101
  }
142
102
  export function colorMode(opts) {
143
103
  const { env } = opts;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
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.3",
3
+ "version": "1.0.5",
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,
@@ -11,4 +11,5 @@ export type ModelMetadataResult = {
11
11
  };
12
12
  export declare function resetModelMetadataCacheForTests(): void;
13
13
  export declare function resolveModelMetadata(model: string, structuredCatalog?: string): ModelMetadataResult;
14
- export declare function managedGpt56Slug(model: string): "gpt-5.6" | "gpt-5.6-sol" | "gpt-5.6-terra" | null;
14
+ export type ManagedModelSlug = "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5.6" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna";
15
+ export declare function managedGpt56Slug(model: string): ManagedModelSlug | null;
@@ -39,7 +39,15 @@ export function resolveModelMetadata(model, structuredCatalog) {
39
39
  }
40
40
  export function managedGpt56Slug(model) {
41
41
  const normalized = model.trim().toLowerCase();
42
- for (const slug of ["gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6"]) {
42
+ for (const slug of [
43
+ "gpt-6-astra",
44
+ "gpt-6-sol",
45
+ "gpt-6-luna",
46
+ "gpt-5.6-sol",
47
+ "gpt-5.6-terra",
48
+ "gpt-5.6-luna",
49
+ "gpt-5.6",
50
+ ]) {
43
51
  if (normalized === slug || normalized.endsWith(`.${slug}`) || normalized.endsWith(`/${slug}`)) {
44
52
  return slug;
45
53
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/rules",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
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.3",
3
+ "version": "1.0.5",
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.3",
3
+ "version": "1.0.5",
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.3",
3
+ "version": "1.0.5",
4
4
  "description": "Local review-gated knowledge records for the LitCodex Wikify surface.",
5
5
  "type": "module",
6
6
  "private": true,