jig-console 0.0.0-stage → 0.1.1

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 (137) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +77 -2
  3. package/dist/commands/config.d.ts +8 -0
  4. package/dist/commands/config.d.ts.map +1 -0
  5. package/dist/commands/config.js +224 -0
  6. package/dist/commands/config.js.map +1 -0
  7. package/dist/commands/convert.d.ts +10 -0
  8. package/dist/commands/convert.d.ts.map +1 -0
  9. package/dist/commands/convert.js +40 -0
  10. package/dist/commands/convert.js.map +1 -0
  11. package/dist/commands/history.d.ts +8 -0
  12. package/dist/commands/history.d.ts.map +1 -0
  13. package/dist/commands/history.js +112 -0
  14. package/dist/commands/history.js.map +1 -0
  15. package/dist/commands/init.d.ts +7 -0
  16. package/dist/commands/init.d.ts.map +1 -0
  17. package/dist/commands/init.js +225 -0
  18. package/dist/commands/init.js.map +1 -0
  19. package/dist/commands/pipeline.d.ts +17 -0
  20. package/dist/commands/pipeline.d.ts.map +1 -0
  21. package/dist/commands/pipeline.js +137 -0
  22. package/dist/commands/pipeline.js.map +1 -0
  23. package/dist/commands/play.d.ts +13 -0
  24. package/dist/commands/play.d.ts.map +1 -0
  25. package/dist/commands/play.js +109 -0
  26. package/dist/commands/play.js.map +1 -0
  27. package/dist/commands/providers.d.ts +17 -0
  28. package/dist/commands/providers.d.ts.map +1 -0
  29. package/dist/commands/providers.js +161 -0
  30. package/dist/commands/providers.js.map +1 -0
  31. package/dist/commands/recipes.d.ts +16 -0
  32. package/dist/commands/recipes.d.ts.map +1 -0
  33. package/dist/commands/recipes.js +135 -0
  34. package/dist/commands/recipes.js.map +1 -0
  35. package/dist/commands/replay.d.ts +40 -0
  36. package/dist/commands/replay.d.ts.map +1 -0
  37. package/dist/commands/replay.js +206 -0
  38. package/dist/commands/replay.js.map +1 -0
  39. package/dist/commands/run.d.ts +3 -0
  40. package/dist/commands/run.d.ts.map +1 -0
  41. package/dist/commands/run.js +14 -0
  42. package/dist/commands/run.js.map +1 -0
  43. package/dist/commands/show.d.ts +15 -0
  44. package/dist/commands/show.d.ts.map +1 -0
  45. package/dist/commands/show.js +39 -0
  46. package/dist/commands/show.js.map +1 -0
  47. package/dist/commands/status.d.ts +6 -0
  48. package/dist/commands/status.d.ts.map +1 -0
  49. package/dist/commands/status.js +77 -0
  50. package/dist/commands/status.js.map +1 -0
  51. package/dist/commands/validate.d.ts +6 -0
  52. package/dist/commands/validate.d.ts.map +1 -0
  53. package/dist/commands/validate.js +36 -0
  54. package/dist/commands/validate.js.map +1 -0
  55. package/dist/help/jig-help.d.ts +25 -0
  56. package/dist/help/jig-help.d.ts.map +1 -0
  57. package/dist/help/jig-help.js +147 -0
  58. package/dist/help/jig-help.js.map +1 -0
  59. package/dist/index.d.ts +3 -0
  60. package/dist/index.d.ts.map +1 -0
  61. package/dist/index.js +216 -0
  62. package/dist/index.js.map +1 -0
  63. package/dist/keys.d.ts +14 -0
  64. package/dist/keys.d.ts.map +1 -0
  65. package/dist/keys.js +68 -0
  66. package/dist/keys.js.map +1 -0
  67. package/dist/live-view.d.ts +90 -0
  68. package/dist/live-view.d.ts.map +1 -0
  69. package/dist/live-view.js +239 -0
  70. package/dist/live-view.js.map +1 -0
  71. package/dist/permissions.d.ts +40 -0
  72. package/dist/permissions.d.ts.map +1 -0
  73. package/dist/permissions.js +88 -0
  74. package/dist/permissions.js.map +1 -0
  75. package/dist/providers.d.ts +68 -0
  76. package/dist/providers.d.ts.map +1 -0
  77. package/dist/providers.js +230 -0
  78. package/dist/providers.js.map +1 -0
  79. package/dist/session/app.d.ts +28 -0
  80. package/dist/session/app.d.ts.map +1 -0
  81. package/dist/session/app.js +458 -0
  82. package/dist/session/app.js.map +1 -0
  83. package/dist/session/ascii.d.ts +5 -0
  84. package/dist/session/ascii.d.ts.map +1 -0
  85. package/dist/session/ascii.js +39 -0
  86. package/dist/session/ascii.js.map +1 -0
  87. package/dist/session/commands.d.ts +26 -0
  88. package/dist/session/commands.d.ts.map +1 -0
  89. package/dist/session/commands.js +828 -0
  90. package/dist/session/commands.js.map +1 -0
  91. package/dist/session/controller.d.ts +291 -0
  92. package/dist/session/controller.d.ts.map +1 -0
  93. package/dist/session/controller.js +779 -0
  94. package/dist/session/controller.js.map +1 -0
  95. package/dist/session/editor.d.ts +60 -0
  96. package/dist/session/editor.d.ts.map +1 -0
  97. package/dist/session/editor.js +128 -0
  98. package/dist/session/editor.js.map +1 -0
  99. package/dist/session/jig-theme.json +1 -0
  100. package/dist/session/keys.d.ts +26 -0
  101. package/dist/session/keys.d.ts.map +1 -0
  102. package/dist/session/keys.js +95 -0
  103. package/dist/session/keys.js.map +1 -0
  104. package/dist/session/lines.d.ts +65 -0
  105. package/dist/session/lines.d.ts.map +1 -0
  106. package/dist/session/lines.js +370 -0
  107. package/dist/session/lines.js.map +1 -0
  108. package/dist/session/markdown.d.ts +13 -0
  109. package/dist/session/markdown.d.ts.map +1 -0
  110. package/dist/session/markdown.js +188 -0
  111. package/dist/session/markdown.js.map +1 -0
  112. package/dist/session/models.d.ts +24 -0
  113. package/dist/session/models.d.ts.map +1 -0
  114. package/dist/session/models.js +17 -0
  115. package/dist/session/models.js.map +1 -0
  116. package/dist/session/start.d.ts +27 -0
  117. package/dist/session/start.d.ts.map +1 -0
  118. package/dist/session/start.js +140 -0
  119. package/dist/session/start.js.map +1 -0
  120. package/dist/session/theme.d.ts +137 -0
  121. package/dist/session/theme.d.ts.map +1 -0
  122. package/dist/session/theme.js +129 -0
  123. package/dist/session/theme.js.map +1 -0
  124. package/dist/session-runner.d.ts +107 -0
  125. package/dist/session-runner.d.ts.map +1 -0
  126. package/dist/session-runner.js +463 -0
  127. package/dist/session-runner.js.map +1 -0
  128. package/dist/terminal-width.d.ts +7 -0
  129. package/dist/terminal-width.d.ts.map +1 -0
  130. package/dist/terminal-width.js +45 -0
  131. package/dist/terminal-width.js.map +1 -0
  132. package/dist/topology-arg.d.ts +12 -0
  133. package/dist/topology-arg.d.ts.map +1 -0
  134. package/dist/topology-arg.js +26 -0
  135. package/dist/topology-arg.js.map +1 -0
  136. package/docs/jig-help.md +70 -0
  137. package/package.json +73 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAC/C,0EAA0E;AAC1E,4EAA4E;AAC5E,mEAAmE;AAEnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAA2B,MAAM,sBAAsB,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA2B;IAC1D,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACjE,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}
@@ -0,0 +1,15 @@
1
+ export interface ShowOptions {
2
+ layout?: string;
3
+ width?: string;
4
+ sight?: boolean;
5
+ plain?: boolean;
6
+ model?: string;
7
+ /** Animate a dry run on the scripted model, until a key or Ctrl+C. */
8
+ play?: boolean;
9
+ speed?: string;
10
+ once?: boolean;
11
+ frames?: string;
12
+ record?: string;
13
+ }
14
+ export declare function showCommand(topologyArg: string, options: ShowOptions): Promise<void>;
15
+ //# sourceMappingURL=show.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1F"}
@@ -0,0 +1,39 @@
1
+ // ============================================
2
+ // CLI: show a topology at rest
3
+ // ============================================
4
+ // `jig show <topology>` draws a built-in topology or a definition file
5
+ // on the core's grid, in the layout the terminal's width allows. --sight adds
6
+ // the walls, measured with a mock model: no network, no tokens. --play
7
+ // animates a dry run of it on the same scripted kind of model (play.ts).
8
+ import chalk from "chalk";
9
+ import { draw, drawingOf, initialRunState, layoutFor, measureSight, toANSI, toText } from "jig-core";
10
+ import { formatIssues, resolveTopology } from "../topology-arg.js";
11
+ import { playTopology } from "./play.js";
12
+ const LAYOUTS = ["auto", "horizontal", "vertical", "strip"];
13
+ export async function showCommand(topologyArg, options) {
14
+ // The engine's own log stays out of a drawing.
15
+ process.env.JIG_LOG_LEVEL ??= "warn";
16
+ try {
17
+ if (options.layout && !LAYOUTS.includes(options.layout))
18
+ throw new Error(`--layout must be one of: ${LAYOUTS.join(", ")}`);
19
+ const resolved = await resolveTopology(topologyArg);
20
+ if (resolved.warnings.length)
21
+ process.stderr.write(chalk.yellow(`${formatIssues(resolved.warnings)}\n`));
22
+ if (options.play) {
23
+ await playTopology(resolved, options);
24
+ return;
25
+ }
26
+ const sight = options.sight ? await measureSight(resolved.topology) : undefined;
27
+ const drawing = drawingOf(resolved.topology, { sight, source: resolved.source, model: options.model, builtIn: resolved.builtIn });
28
+ const width = options.width ? parseInt(options.width, 10) : process.stdout.isTTY ? process.stdout.columns : 120;
29
+ const layout = !options.layout || options.layout === "auto" ? layoutFor(drawing, width, { sight: Boolean(sight) }) : options.layout;
30
+ const grid = draw(drawing, initialRunState(0), layout, { sight: true, width });
31
+ const color = !options.plain && process.stdout.isTTY && !process.env.NO_COLOR;
32
+ process.stdout.write(`${color ? toANSI(grid) : toText(grid)}\n`);
33
+ }
34
+ catch (e) {
35
+ process.stderr.write(chalk.red(` ✗ ${e.message}\n`));
36
+ process.exitCode = 2;
37
+ }
38
+ }
39
+ //# sourceMappingURL=show.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"show.js","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ interface StatusOptions {
2
+ dir?: string;
3
+ }
4
+ export declare function statusCommand(options: StatusOptions): Promise<void>;
5
+ export {};
6
+ //# sourceMappingURL=status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AASA,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DzE"}
@@ -0,0 +1,77 @@
1
+ // ============================================
2
+ // CLI: status command: Show workspace status
3
+ // ============================================
4
+ import * as fs from 'fs/promises';
5
+ import * as path from 'path';
6
+ import chalk from 'chalk';
7
+ import { IterationLogger, PlanManager } from 'jig-core';
8
+ export async function statusCommand(options) {
9
+ const workingDir = path.resolve(options.dir || '.');
10
+ console.log(chalk.cyan('\nJig: workspace status\n'));
11
+ console.log(chalk.gray(` Directory: ${workingDir}\n`));
12
+ // Check for key files
13
+ const files = [
14
+ { name: 'PROMPT.md', required: true },
15
+ { name: 'PLAN.md', required: true },
16
+ { name: 'specs/', required: false },
17
+ { name: '.env', required: false },
18
+ { name: '.jig/', required: false },
19
+ ];
20
+ console.log(chalk.white(' Files:'));
21
+ for (const file of files) {
22
+ const exists = await fileExists(path.join(workingDir, file.name));
23
+ const icon = exists ? chalk.green('✓') : file.required ? chalk.red('✗') : chalk.gray('◦');
24
+ console.log(` ${icon} ${file.name}`);
25
+ }
26
+ // Show plan status
27
+ const planManager = new PlanManager(workingDir);
28
+ const planExists = await planManager.exists();
29
+ if (planExists) {
30
+ const items = await planManager.read();
31
+ const counts = {
32
+ pending: items.filter((i) => i.status === 'pending').length,
33
+ 'in-progress': items.filter((i) => i.status === 'in-progress').length,
34
+ completed: items.filter((i) => i.status === 'completed').length,
35
+ failed: items.filter((i) => i.status === 'failed').length,
36
+ blocked: items.filter((i) => i.status === 'blocked').length,
37
+ };
38
+ console.log(chalk.white('\n Plan Status:'));
39
+ console.log(chalk.gray(` Total items: ${items.length}`));
40
+ if (counts.pending > 0)
41
+ console.log(chalk.white(` ◦ Pending: ${counts.pending}`));
42
+ if (counts['in-progress'] > 0)
43
+ console.log(chalk.cyan(` ~ In progress: ${counts['in-progress']}`));
44
+ if (counts.completed > 0)
45
+ console.log(chalk.green(` ✓ Completed: ${counts.completed}`));
46
+ if (counts.failed > 0)
47
+ console.log(chalk.red(` ✗ Failed: ${counts.failed}`));
48
+ if (counts.blocked > 0)
49
+ console.log(chalk.yellow(` ⊘ Blocked: ${counts.blocked}`));
50
+ const next = await planManager.getNextItem();
51
+ if (next) {
52
+ console.log(chalk.white(`\n Next item: ${chalk.cyan(next.title)}`));
53
+ }
54
+ }
55
+ // Show run history
56
+ try {
57
+ const runDirs = (await IterationLogger.listRuns(workingDir)).reverse().map((name) => ({ name }));
58
+ if (runDirs.length > 0) {
59
+ console.log(chalk.white(`\n Past runs: ${runDirs.length}`));
60
+ console.log(chalk.gray(` Latest: ${runDirs[runDirs.length - 1].name}`));
61
+ }
62
+ }
63
+ catch {
64
+ // No runs yet
65
+ }
66
+ console.log('');
67
+ }
68
+ async function fileExists(filePath) {
69
+ try {
70
+ await fs.access(filePath);
71
+ return true;
72
+ }
73
+ catch {
74
+ return false;
75
+ }
76
+ }
77
+ //# sourceMappingURL=status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,6CAA6C;AAC7C,+CAA+C;AAE/C,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMxD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAEpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,IAAI,CAAC,CAAC,CAAC;IAExD,sBAAsB;IACtB,MAAM,KAAK,GAAG;QACZ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;QACrC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;QACnC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QACjC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;KACnC,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1F,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,mBAAmB;IACnB,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;IAE9C,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YAC3D,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;YACrE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;YAC/D,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YACzD,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;SAC5D,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzF,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACtG,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrF,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAE1F,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEjG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
@@ -0,0 +1,6 @@
1
+ export interface ValidateOptions {
2
+ dialect?: string;
3
+ json?: boolean;
4
+ }
5
+ export declare function validateCommand(arg: string, options: ValidateOptions): Promise<void>;
6
+ //# sourceMappingURL=validate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1F"}
@@ -0,0 +1,36 @@
1
+ // ============================================
2
+ // CLI: validate a definition file
3
+ // ============================================
4
+ // Through the core's formats module: the syntax, the dialect, and every
5
+ // problem at its path and line. Exits 0 when the file is valid, 1 otherwise.
6
+ import { existsSync } from "fs";
7
+ import { readFile } from "fs/promises";
8
+ import chalk from "chalk";
9
+ import { BUILT_IN_TOPOLOGIES, builtinFile, describeIssue, validateTopologyText } from "jig-core";
10
+ export async function validateCommand(arg, options) {
11
+ try {
12
+ // A built-in topology by its name is its file inside the installed jig-core.
13
+ const file = !existsSync(arg) && BUILT_IN_TOPOLOGIES.includes(arg) ? builtinFile(arg) : arg;
14
+ const result = validateTopologyText(await readFile(file, "utf-8"), { filename: file, dialect: options.dialect });
15
+ if (options.json) {
16
+ process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
17
+ }
18
+ else {
19
+ const what = result.dialect ? `${result.dialect} in ${result.syntax}` : (result.syntax ?? "unreadable");
20
+ const errors = result.issues.filter((i) => i.severity === "error").length;
21
+ const warnings = result.issues.length - errors;
22
+ process.stdout.write(`${file}: ${what}\n`);
23
+ for (const i of result.issues)
24
+ process.stdout.write(`${(i.severity === "error" ? chalk.red : chalk.yellow)(describeIssue(i))}\n`);
25
+ process.stdout.write(result.valid
26
+ ? chalk.green(` ✓ valid${warnings ? `, ${warnings} warning${warnings > 1 ? "s" : ""}` : ""}\n`)
27
+ : chalk.red(` ✗ not valid: ${errors} error${errors > 1 ? "s" : ""}\n`));
28
+ }
29
+ process.exitCode = result.valid ? 0 : 1;
30
+ }
31
+ catch (e) {
32
+ process.stderr.write(chalk.red(` ✗ ${e.message}\n`));
33
+ process.exitCode = 2;
34
+ }
35
+ }
36
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import { type AgentTool, type ToolDefinition, type Topology } from "jig-core";
2
+ export declare const JIG_HELP = "jig_help";
3
+ /** The versions of the two packages, as installed. */
4
+ export declare function versions(): {
5
+ console: string;
6
+ core: string;
7
+ };
8
+ export interface HelpSection {
9
+ title: string;
10
+ body: string;
11
+ }
12
+ /** The documentation as sections: the shipped file, then what the code says now. */
13
+ export declare function helpSections(): HelpSection[];
14
+ /** The sections that answer a question best, best first: each word weighted by how few sections use it, more in a title. */
15
+ export declare function searchHelp(query: string, sections?: HelpSection[]): HelpSection[];
16
+ /** The tool: the best section whole, and the titles of the next ones. Read-only, and never asks. */
17
+ export declare class JigHelpTool implements AgentTool {
18
+ definition: ToolDefinition;
19
+ execute(args: Record<string, unknown>): Promise<string>;
20
+ }
21
+ /** The block every role's prompt ends with, after where it runs: what Jig is, and where to look for the rest. */
22
+ export declare function aboutJig(): string;
23
+ /** A topology where every role may call jig_help, whatever its own tool list says. */
24
+ export declare function offerJigHelp(t: Topology): Topology;
25
+ //# sourceMappingURL=jig-help.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jig-help.d.ts","sourceRoot":"","sources":["../../src/help/jig-help.ts"],"names":[],"mappings":"AAYA,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGxG,eAAO,MAAM,QAAQ,aAAa,CAAC;AAUnC,sDAAsD;AACtD,wBAAgB,QAAQ,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAE5D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oFAAoF;AACpF,wBAAgB,YAAY,IAAI,WAAW,EAAE,CA8B5C;AAqBD,4HAA4H;AAC5H,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,gBAAiB,GAAG,WAAW,EAAE,CAmBlF;AAeD,oGAAoG;AACpG,qBAAa,WAAY,YAAW,SAAS;IAC3C,UAAU,iBAAc;IAElB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAU9D;AAED,iHAAiH;AACjH,wBAAgB,QAAQ,IAAI,MAAM,CAQjC;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAQlD"}
@@ -0,0 +1,147 @@
1
+ // ============================================
2
+ // Jig's own documentation, for the roles to answer questions about Jig
3
+ // ============================================
4
+ // Every role gets a short "about Jig" block in its environment and a
5
+ // read-only tool, jig_help, that searches Jig's documentation: the file
6
+ // shipped in the package (docs/jig-help.md) plus what is read from the code
7
+ // when it runs, so it never drifts: every slash command from the command
8
+ // table, the built-in topologies with their roles and brains, the versions.
9
+ // The tool never asks for permission (it reads nothing of the person's), and
10
+ // what it returns is written documentation, not something measured.
11
+ import { readFileSync } from "node:fs";
12
+ import { coreVersion, listRecipes } from "jig-core";
13
+ import { COMMANDS } from "../session/commands.js";
14
+ export const JIG_HELP = "jig_help";
15
+ const pkg = (url) => {
16
+ try {
17
+ return JSON.parse(readFileSync(url, "utf-8")).version ?? "unknown";
18
+ }
19
+ catch {
20
+ return "unknown";
21
+ }
22
+ };
23
+ /** The versions of the two packages, as installed. */
24
+ export function versions() {
25
+ return { console: pkg(new URL("../../package.json", import.meta.url)), core: coreVersion() };
26
+ }
27
+ /** The documentation as sections: the shipped file, then what the code says now. */
28
+ export function helpSections() {
29
+ let text = "";
30
+ try {
31
+ text = readFileSync(new URL("../../docs/jig-help.md", import.meta.url), "utf-8");
32
+ }
33
+ catch {
34
+ text = "## What Jig is\n\nJig is a Joint Inference Graph: a topology of roles, each on a model, run from the jig terminal session.";
35
+ }
36
+ const sections = [];
37
+ for (const part of text.split(/^## /m).slice(1)) {
38
+ const [title, ...rest] = part.split("\n");
39
+ sections.push({ title: title.trim(), body: rest.join("\n").trim() });
40
+ }
41
+ sections.push({
42
+ title: "Slash commands",
43
+ body: COMMANDS.map((c) => `- \`${c.usage}\`: ${c.summary}.`).join("\n"),
44
+ });
45
+ sections.push({
46
+ title: "Built-in topologies, their roles and brains",
47
+ body: listRecipes()
48
+ .map((r) => {
49
+ const t = r;
50
+ const roles = t.nodes.map((n) => `${t.faces?.[n.id]?.label ?? n.id} (id ${n.id}, ${n.config.brain?.brain ? `brain ${n.config.brain.brain}` : "the session's default model"})`);
51
+ const advisors = (t.consults ?? []).map((c) => `${c.role.face.label} (id ${c.role.id}, consulted by ${c.from}${c.role.brain?.brain ? `, brain ${c.role.brain.brain}` : ""})`);
52
+ return `- \`${t.id}\`, ${t.name}: ${[...roles, ...advisors].join(", ")}.`;
53
+ })
54
+ .join("\n"),
55
+ });
56
+ const v = versions();
57
+ sections.push({ title: "Version", body: `jig-console ${v.console}, jig-core ${v.core}. \`jig --version\` prints it.` });
58
+ return sections;
59
+ }
60
+ // A question in Spanish is common: its key words are read as their English twins.
61
+ const TWINS = {
62
+ que: "what", es: "is", cambiar: "change", cambio: "change", modelo: "model", modelos: "model", topologia: "topology", topologias: "topology",
63
+ permiso: "permission", permisos: "permission", comando: "command", comandos: "command", proveedor: "provider", proveedores: "provider", clave: "key",
64
+ claves: "key", archivo: "file", archivos: "file", donde: "where", version: "version", cerebro: "brain", cerebros: "brain", rol: "role", roles: "role",
65
+ modo: "mode", modos: "mode", teclas: "keys", sesion: "session", ayuda: "help", comprobar: "check", verificar: "check",
66
+ };
67
+ const STOP = new Set(["the", "a", "an", "of", "to", "do", "does", "are", "i", "in", "for", "and", "or", "how", "can", "my", "on", "with", "de", "la", "el", "en", "como", "un", "una", "los", "las", "del", "se", "y", "o", "mi", "por", "para"]);
68
+ const words = (text) => text
69
+ .toLowerCase()
70
+ .normalize("NFD")
71
+ .replace(/[̀-ͯ]/g, "")
72
+ .split(/[^a-z0-9_]+/)
73
+ .filter(Boolean)
74
+ .map((w) => TWINS[w] ?? w);
75
+ const stem = (w) => w.replace(/(ing|es|ed|s)$/, "") || w;
76
+ /** The sections that answer a question best, best first: each word weighted by how few sections use it, more in a title. */
77
+ export function searchHelp(query, sections = helpSections()) {
78
+ const terms = [...new Set(words(query).filter((w) => !STOP.has(w)).map(stem))];
79
+ if (!terms.length)
80
+ return [];
81
+ const docs = sections.map((s) => ({ head: words(s.title).map(stem), body: words(s.body).map(stem) }));
82
+ const has = (d, t) => d.head.includes(t) || d.body.some((w) => w === t || (t.length >= 5 && w.startsWith(t)));
83
+ const weight = (t) => Math.log(1 + sections.length / Math.max(1, docs.filter((d) => has(d, t)).length));
84
+ const scored = docs.map((d, i) => {
85
+ let score = 0;
86
+ for (const t of terms) {
87
+ const w = weight(t);
88
+ if (d.head.includes(t))
89
+ score += 3 * w;
90
+ score += Math.min(3, d.body.filter((x) => x === t || (t.length >= 5 && x.startsWith(t))).length) * w;
91
+ }
92
+ return { s: sections[i], score, i };
93
+ });
94
+ return scored
95
+ .filter((x) => x.score > 0)
96
+ .sort((a, b) => b.score - a.score || a.i - b.i)
97
+ .map((x) => x.s);
98
+ }
99
+ const DEFINITION = {
100
+ name: JIG_HELP,
101
+ description: "Search Jig's own documentation: what Jig is, the session and its keys, every slash command, permissions and modes, the built-in topologies with their roles and brains, providers, keys and brains, where files live, and the version. Use it whenever you are asked about Jig itself, instead of guessing.",
102
+ parameters: {
103
+ type: "object",
104
+ properties: {
105
+ query: { type: "string", description: "The question or the words to look for, such as 'what is jig' or 'switch topology'" },
106
+ },
107
+ required: ["query"],
108
+ },
109
+ };
110
+ /** The tool: the best section whole, and the titles of the next ones. Read-only, and never asks. */
111
+ export class JigHelpTool {
112
+ definition = DEFINITION;
113
+ async execute(args) {
114
+ const sections = helpSections();
115
+ const found = searchHelp(String(args.query ?? ""), sections);
116
+ const v = versions();
117
+ const mark = `❝ From Jig's own documentation (written, not measured), jig-console ${v.console}`;
118
+ if (!found.length)
119
+ return `${mark}. Nothing matched; its parts are: ${sections.map((s) => s.title).join("; ")}.`;
120
+ const [best, ...more] = found;
121
+ const body = best.body.length > 3500 ? `${best.body.slice(0, 3500)}⋯` : best.body;
122
+ return `${mark}, "${best.title}":\n\n${body}${more.length ? `\n\nAlso about this: ${more.slice(0, 3).map((s) => s.title).join("; ")}.` : ""}`;
123
+ }
124
+ }
125
+ /** The block every role's prompt ends with, after where it runs: what Jig is, and where to look for the rest. */
126
+ export function aboutJig() {
127
+ const v = versions();
128
+ return [
129
+ "About Jig, the program running you:",
130
+ `- You are one role in Jig (jig-console ${v.console}), a Joint Inference Graph: a topology of roles (Plan, Do, Check, Critique, Decide, an Advisor), each on a model, run from the person's terminal session (\`jig\`) or from \`jig run\`.`,
131
+ "- The person types tasks and slash commands (/topology, /models, /permissions, /help) in that session; your tool calls are checked against their permissions before they run.",
132
+ `- Asked about Jig itself (its commands, topologies, models, permissions, providers, files, version), call ${JIG_HELP} and answer from what it returns; never guess.`,
133
+ ].join("\n");
134
+ }
135
+ /** A topology where every role may call jig_help, whatever its own tool list says. */
136
+ export function offerJigHelp(t) {
137
+ const copy = structuredClone(t);
138
+ for (const n of copy.nodes) {
139
+ const policy = n.config.toolPolicy;
140
+ if (policy?.allow && !policy.allow.includes(JIG_HELP))
141
+ n.config = { ...n.config, toolPolicy: { ...policy, allow: [...policy.allow, JIG_HELP] } };
142
+ else if (!policy && n.config.enabledTools?.length && !n.config.enabledTools.includes(JIG_HELP))
143
+ n.config = { ...n.config, enabledTools: [...n.config.enabledTools, JIG_HELP] };
144
+ }
145
+ return copy;
146
+ }
147
+ //# sourceMappingURL=jig-help.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jig-help.js","sourceRoot":"","sources":["../../src/help/jig-help.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}