@yegor256/jinka 0.0.9 → 0.0.11

package/README.md

@@ -7,7 +7,7 @@
 First, you create `~/.jinka/wishes/Make-Me-Happy.md` file:
 
 ```text
-I wish my GitHub repositories were in good shape: `foo/bar` and `foo/bar2`.
+I wish my GitHub repository to be in good shape: `foo/bar`.
 ```
 
 Then, you install `jinka`:
@@ -16,7 +16,7 @@ Then, you install `jinka`:
 npm install -g @yegor256/jinka
 ```
 
-Finally, you run it, giving it the path to your directory with wishes:
+Finally, you run it:
 
 ```bash
 jinka

package/bin/jinka.js

@@ -17,9 +17,12 @@ import { disk } from '../src/disk.js';
 import { tty } from '../src/tty.js';
 import { colorless } from '../src/colorless.js';
 import { log } from '../src/log.js';
+import { pile } from '../src/pile.js';
 import { status } from '../src/status.js';
 import { quota } from '../src/quota.js';
 import { rollouts } from '../src/rollouts.js';
+import { recorded } from '../src/recorded.js';
+import { model } from '../src/model.js';
 import { meters } from '../src/meters.js';
 import { freeze } from '../src/freeze.js';
 import { frozen } from '../src/frozen.js';
@@ -35,6 +38,7 @@ import { jobs } from '../src/jobs.js';
 import { summary } from '../src/summary.js';
 import { summarized } from '../src/summarized.js';
 import { semaphore } from '../src/semaphore.js';
+import { hello } from '../src/hello.js';
 
 const root = join(dirname(fileURLToPath(import.meta.url)), '..');
 const pkg = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
@@ -97,7 +101,10 @@ const a = values.agent === '' ? engine : values.agent;
 const t = tokens();
 const q = quota();
 const c = crew(values.threads, limit, { warn: (text) => screen.notice().warn(text) });
-const j = jobs(genie((engine === 'codex' ? codex : claude)(agent(a), values.model, values.effort, resolve(values.skill)), disk(dir, resolve(values.logs), resolve(values.memory), c), meters([t, engine === 'codex' ? rollouts(q, join(process.env.CODEX_HOME ?? join(homedir(), '.codex'), 'sessions')) : q])));
+const sessions = join(process.env.CODEX_HOME ?? join(homedir(), '.codex'), 'sessions');
+const e = (engine === 'codex' ? codex : claude)(agent(a), values.model, values.effort, resolve(values.skill));
+const d = disk(dir, resolve(values.logs), resolve(values.memory), c);
+const j = jobs(genie(e, d, meters([t, engine === 'codex' ? rollouts(q, sessions) : q]), engine === 'codex' ? () => recorded(model(), sessions) : model));
 const f = freeze(c, { warn: (text) => screen.notice().warn(text) }, () => quit(0));
 const r = release(pkg.version, 'https://registry.npmjs.org/@yegor256/jinka/latest');
 const start = Date.now();
@@ -107,7 +114,7 @@ const screen = summarized(
     ? tty(
       values.color && !process.env.NO_COLOR ? process.stdout : colorless(process.stdout),
       c,
-      status(start, j, a, values.model, t, q),
+      status(start, pile(dir), j, a, values.model, t, q),
       legend(f, r)
     )
     : log(process.stdout),
@@ -118,6 +125,7 @@ process.on('exit', () => screen.close());
 if (tui) {
   r.check();
 }
+screen.notice().warn(`every agent starts as: ${e.command(d.args())}`);
 const quit = (code) => {
   screen.close();
   process.stdout.write('', () => process.stderr.write('', () => process.exit(code)));
@@ -133,6 +141,7 @@ process.on('SIGINT', interrupt);
 keys(process.stdin, f, c, interrupt).listen();
 wheel(process.stdin, screen).listen();
 try {
+  await hello(e, screen.notice()).run(controller.signal);
   await jinka(
     limited(frozen(throttled(wishes(dir, values.interval, values.archive === '' ? '' : resolve(values.archive), values.pause, { warn: (text) => screen.notice().warn(text) }), q, values.throttle, 15 * 60 * 1000, { warn: (text) => screen.notice().warn(text) }), f), values.limit, f),
     j,

package/package.json

@@ -35,5 +35,5 @@
     "test": "c8 --check-coverage --lines 80 mocha"
   },
   "type": "module",
-  "version": "0.0.9"
+  "version": "0.0.11"
 }

package/plugin/skills/clean-up-backlog/SKILL.md

@@ -9,8 +9,7 @@ description: |
   Picks the oldest untouched items, skips those that already have a wish,
     wait for their author, or were triaged within the last day,
     skips pull requests whose latest review requests changes,
-    and writes at most as many new wishes as jinka runs threads,
-    one per item, into the wishes directory.
+    and writes one new wish per item into the wishes directory.
 ---
 
 Target every repository named by the wish.
@@ -31,8 +30,6 @@ Skip issues triaged less than one day ago,
   according to `<owner>/<repo>/triaged.csv`
   in the memory directory given in the prompt.
 
-Write at most as many new wishes per run as jinka runs threads,
-  as the prompt says, across all repositories.
 Write no wish when every candidate was skipped.
 
 Write one Markdown file per item, in the root of the wishes directory.

package/src/agent.js

@@ -15,5 +15,6 @@ export const agent = (command) => Object.freeze({
       );
     }
     return child;
-  }
+  },
+  command: (args) => [command, ...args].map((a) => (/^[\w./\\:=@%+,~-]+$/.test(a) ? a : `'${a.replaceAll("'", "'\\''")}'`)).join(' ')
 });

package/src/claude.js

@@ -1,17 +1,18 @@
 // SPDX-FileCopyrightText: Copyright (c) 2026 Yegor Bugayenko
 // SPDX-License-Identifier: MIT
 
-export const claude = (agent, model, effort, plugin) => Object.freeze({
-  start: (args, signal) => agent.start(
-    [
-      '-p', '--output-format', 'stream-json', '--verbose',
-      '--plugin-dir', plugin,
-      ...args,
-      '--dangerously-skip-permissions',
-      ...(model === '' ? [] : ['--model', model]),
-      ...(effort === '' ? [] : ['--effort', effort])
-    ],
-    signal
-  ),
-  lines: () => []
-});
+export const claude = (agent, model, effort, plugin) => {
+  const full = (args) => [
+    '-p', '--output-format', 'stream-json', '--verbose',
+    '--plugin-dir', plugin,
+    ...args,
+    '--dangerously-skip-permissions',
+    ...(model === '' ? [] : ['--model', model]),
+    ...(effort === '' ? [] : ['--effort', effort])
+  ];
+  return Object.freeze({
+    start: (args, signal) => agent.start(full(args), signal),
+    command: (args) => agent.command(full(args)),
+    lines: () => []
+  });
+};

package/src/codex.js

@@ -3,20 +3,21 @@
 
 import { join } from 'node:path';
 
-export const codex = (agent, model, effort, plugin) => Object.freeze({
-  start: (args, signal) => agent.start(
-    [
-      'exec', '--json',
-      '--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check',
-      ...args,
-      ...(model === '' ? [] : ['--model', model]),
-      ...(effort === '' ? [] : ['--config', `model_reasoning_effort=${effort}`]),
-      '-'
-    ],
-    signal
-  ),
-  lines: () => [
-    `Your skills live in the directory ${join(plugin, 'skills')}, one skill per subdirectory, each described in its SKILL.md file.`,
-    'Before you start, read the descriptions of these skills, and whenever a skill fits your work, read its SKILL.md file and follow it.'
-  ]
-});
+export const codex = (agent, model, effort, plugin) => {
+  const full = (args) => [
+    'exec', '--json',
+    '--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check',
+    ...args,
+    ...(model === '' ? [] : ['--model', model]),
+    ...(effort === '' ? [] : ['--config', `model_reasoning_effort=${effort}`]),
+    '-'
+  ];
+  return Object.freeze({
+    start: (args, signal) => agent.start(full(args), signal),
+    command: (args) => agent.command(full(args)),
+    lines: () => [
+      `Your skills live in the directory ${join(plugin, 'skills')}, one skill per subdirectory, each described in its SKILL.md file.`,
+      'Before you start, read the descriptions of these skills, and whenever a skill fits your work, read its SKILL.md file and follow it.'
+    ]
+  });
+};

package/src/disk.js

@@ -2,24 +2,38 @@
 // SPDX-License-Identifier: MIT
 
 import { createWriteStream } from 'node:fs';
-import { mkdir } from 'node:fs/promises';
+import { mkdir, readdir } from 'node:fs/promises';
 import { join, dirname, extname } from 'node:path';
 
 export const disk = (wishes, logs, memory, crew) => Object.freeze({
-  lines: (wish) => [
-    `The wish is written in the file ${join(wishes, wish.name())}, ${wish.fate()}.`,
-    'Never delete, move, or rename the file of this wish yourself, even after you split it into smaller wishes, since Jinka takes care of it.',
-    `All wishes live in the directory ${wishes}, and you may add new wishes there as Markdown files.`,
-    `If this wish is an atomic job that involves no other jobs, make it come true yourself;`,
-    `otherwise, do not do it yourself, but split it into smaller wishes`,
-    `and write each of them as a separate Markdown file in the directory ${join(wishes, dirname(wish.name()))}.`,
-    `Always start the name of every new wish file with a small English letter, never with a capital one.`,
-    `In every Git repository you touch, do all your work inside a separate Git worktree, never in the main directory of the repository, so that other wishes running at the same time do not see your changes.`,
-    `Never spend time waiting while doing a wish, neither sleeping nor polling for a build, a review, a merge, or anything else;`,
-    `if something must happen first, write a new wish that waits for it and finishes the job, and then complete the current wish right away.`,
-    `Your memory lives in the directory ${memory}, keep there what the skills tell you to keep.`,
-    `Jinka runs ${crew.size()} threads right now, so up to ${crew.size()} wishes run at once.`
-  ],
+  lines: async (wish) => {
+    const count = (await readdir(wishes, { recursive: true, withFileTypes: true }))
+      .filter((f) => f.isFile() && f.name.endsWith('.md'))
+      .length;
+    return [
+      `The wish is written in the file ${join(wishes, wish.name())}, ${wish.fate()}.`,
+      'Never delete, move, or rename the file of this wish yourself, even after you split it into smaller wishes, since Jinka takes care of it.',
+      `All wishes live in the directory ${wishes}, and you may add new wishes there as Markdown files.`,
+      `If this wish is an atomic job that involves no other jobs, make it come true yourself;`,
+      `otherwise, do not do it yourself, but split it into smaller wishes`,
+      `and write each of them as a separate Markdown file in the directory ${join(wishes, dirname(wish.name()))}.`,
+      `Always start the name of every new wish file with a small English letter, never with a capital one.`,
+      'Write every new wish the way a person would ask for something, in a few plain sentences that say what must be achieved and give exact links to the issue, pull request, or repository.',
+      'Keep every new wish shorter than 1000 characters.',
+      'Never copy the text of the current wish, or of these instructions, into a new wish, since Jinka gives these instructions to every wish anyway;',
+      'copy only the facts that the new wish cannot find on its own, such as a chat ID or a token that the current wish explicitly asks to pass along.',
+      'Leave evidence, observations, logs, and the history of your work out of a new wish, since the new wish checks the current state by itself.',
+      `Write at most ${crew.size()} new wishes while doing this wish;`,
+      'if more work remains than they can hold, make one of them a continuation that splits the rest later.',
+      `The directory ${wishes} holds ${count} wishes right now.`,
+      ...(count >= 100 ? ['Since that is 100 or more, never split this wish into new wishes, but do all of it yourself, and write no other new wish either, not even to hand over waiting.'] : []),
+      `In every Git repository you touch, do all your work inside a separate Git worktree, never in the main directory of the repository, so that other wishes running at the same time do not see your changes.`,
+      `Never spend time waiting while doing a wish, neither sleeping nor polling for a build, a review, a merge, or anything else;`,
+      `if something must happen first, write a new wish that waits for it and finishes the job, and then complete the current wish right away.`,
+      `Your memory lives in the directory ${memory}, keep there what the skills tell you to keep.`,
+      `Jinka runs ${crew.size()} threads right now, so up to ${crew.size()} wishes run at once.`
+    ];
+  },
   args: () => ['--add-dir', wishes, '--add-dir', memory],
   log: async (wish) => {
     const file = join(

package/src/genie.js

@@ -4,16 +4,15 @@
 import { createInterface } from 'node:readline';
 import { event } from './event.js';
 import { tokens } from './tokens.js';
-import { model } from './model.js';
 
-export const genie = (engine, disk, meter) => Object.freeze({
+export const genie = (engine, disk, meter, model) => Object.freeze({
   run: async (wish, row, signal) => {
     const prompt = [
       'Make this wish come true, working on your own without asking any questions:',
       '',
       await wish.text(),
       '',
-      ...disk.lines(wish),
+      ...(await disk.lines(wish)),
       ...engine.lines(),
       'When you finish, end with a single plain sentence that says what you did.',
       'On the next line, write the full URL of the GitHub issue or pull request you worked on, if there was one.'

package/src/hello.js

@@ -0,0 +1,29 @@
+// SPDX-FileCopyrightText: Copyright (c) 2026 Yegor Bugayenko
+// SPDX-License-Identifier: MIT
+
+import { createInterface } from 'node:readline';
+import { event } from './event.js';
+
+export const hello = (engine, notice) => Object.freeze({
+  run: (signal) => new Promise((resolve, reject) => {
+    const child = engine.start([], signal);
+    const answer = [''];
+    child.stdin.on('error', () => {});
+    child.stdin.end('Tell me, who you are, in a very short single sentence.');
+    child.stderr.resume();
+    createInterface({ input: child.stdout }).on('line', (line) => {
+      answer[0] = event(line, 0).summary() || answer[0];
+    });
+    child.on('error', (e) => (signal.aborted ? resolve() : reject(new Error(`Cannot start the agent "${child.spawnfile}": ${e.message}`))));
+    child.on('close', (code) => {
+      if (signal.aborted) {
+        resolve();
+      } else if (code === 0) {
+        notice.info(`the agent says: ${answer[0]}`);
+        resolve();
+      } else {
+        reject(new Error(`The agent "${child.spawnfile}" exited with code ${code} while telling who it is: ${answer[0]}`));
+      }
+    });
+  })
+});

package/src/model.js

@@ -15,7 +15,11 @@ export const model = () => {
       }
     },
     text: () => {
-      const parts = (names.at(-1) ?? '').replace(/^claude-/, '').replace(/-\d{8}$/, '').split('-').filter((p) => p !== '');
+      const name = names.at(-1) ?? '';
+      if (!name.startsWith('claude-')) {
+        return name;
+      }
+      const parts = name.replace(/^claude-/, '').replace(/-\d{8}$/, '').split('-').filter((p) => p !== '');
       return [
         ...parts.filter((p) => !/^\d+$/.test(p)).map((p) => `${p[0].toUpperCase()}${p.slice(1)}`),
         parts.filter((p) => /^\d+$/.test(p)).join('.')

package/src/pile.js

@@ -0,0 +1,8 @@
+// SPDX-FileCopyrightText: Copyright (c) 2026 Yegor Bugayenko
+// SPDX-License-Identifier: MIT
+
+import { readdirSync } from 'node:fs';
+
+export const pile = (dir) => Object.freeze({
+  text: () => `${readdirSync(dir, { recursive: true, withFileTypes: true }).filter((f) => f.isFile() && f.name.endsWith('.md')).length}`
+});

package/src/recorded.js

@@ -0,0 +1,34 @@
+// SPDX-FileCopyrightText: Copyright (c) 2026 Yegor Bugayenko
+// SPDX-License-Identifier: MIT
+
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const recorded = (origin, dir) => {
+  let thread = '';
+  return Object.freeze({
+    add: (line) => {
+      origin.add(line);
+      try {
+        const json = JSON.parse(line);
+        if (json.type === 'thread.started' && typeof json.thread_id === 'string') {
+          thread = json.thread_id;
+        }
+        if (json.type === 'turn.completed' && thread !== '' && existsSync(dir)) {
+          readdirSync(dir, { recursive: true })
+            .map(String)
+            .filter((path) => path.endsWith(`-${thread}.jsonl`))
+            .flatMap((path) => readFileSync(join(dir, path), 'utf8').split('\n'))
+            .filter((text) => text.includes('"turn_context"'))
+            .map((text) => JSON.parse(text).payload?.model)
+            .filter((name) => typeof name === 'string')
+            .slice(-1)
+            .forEach((name) => origin.add(JSON.stringify({ type: 'system', subtype: 'init', model: name })));
+        }
+      } catch {
+        return;
+      }
+    },
+    text: () => origin.text()
+  });
+};

package/src/status.js

@@ -4,12 +4,12 @@
 import { styleText } from 'node:util';
 import { duration } from './duration.js';
 
-export const status = (start, jobs, agent, model, tokens, quota) => Object.freeze({
+export const status = (start, pile, jobs, agent, model, tokens, quota) => Object.freeze({
   text: () => {
     const now = Date.now();
     return [
       `up:${styleText('bgGray', duration(now - start).hours(), { validateStream: false })}`,
-      `done:${styleText('bgGray', jobs.text(), { validateStream: false })}`,
+      `wishes:${styleText('bgGray', `${pile.text()}/${jobs.text()}`, { validateStream: false })}`,
       `agent:${styleText('bgGray', agent, { validateStream: false })}`,
       `model:${styleText('bgGray', model === '' ? 'default' : model, { validateStream: false })}`,
       `tokens:${styleText('bgGray', tokens.text(), { validateStream: false })}`,

package/src/tty.js

@@ -17,9 +17,18 @@ export const tty = (stream, crew, status, legend) => {
     const [left, right] = text.split('\t');
     return `${left}${' '.repeat(Math.max(1, width - 1 - stripVTControlCharacters(left).length - stripVTControlCharacters(right).length))}${right}`;
   };
-  const wrap = (text, width) => (
-    stripVTControlCharacters(text).length <= width || width < 3 ? [text] : [sliceAnsi(text, 0, width), ...wrap(`  ${sliceAnsi(text, width)}`, width)]
-  );
+  const cut = (text, width) => {
+    const plain = stripVTControlCharacters(text);
+    const space = plain.lastIndexOf(' ', width);
+    return space > 2 && plain.slice(space + 1).split(' ')[0].length <= width - 2 ? [space, space + 1] : [width, width];
+  };
+  const wrap = (text, width) => {
+    if (stripVTControlCharacters(text).length <= width || width < 3) {
+      return [text];
+    }
+    const [end, start] = cut(text, width);
+    return [sliceAnsi(text, 0, end), ...wrap(`  ${sliceAnsi(text, start)}`, width)];
+  };
   const draw = () => {
     const rows = stream.rows || 24;
     const wands = crew.indexes().map((i) => [i, lines.get(i) ?? { head: '', tail: '', start: Date.now() }]);
@@ -63,9 +72,9 @@ export const tty = (stream, crew, status, legend) => {
     lines.set(index, { head, tail, start: head === line.head ? line.start : Date.now() });
     paint();
   };
-  const note = (text) => {
+  const note = (level, text) => {
     notes.push(
-      `${new Date().toTimeString().slice(0, 8)} ${text.replace(/https:\/\/github\.com\/([^/\s]+\/[^/\s]+)\/(?:issues|pull)\/(\d+)/g, (url, repo, number) => `\x1b]8;;${url}\x07\x1b[38;2;106;113;247m${repo}#${number}\x1b[39m\x1b]8;;\x07`)}`
+      `${level === 'warn' ? `\x1b[38;2;255;135;0m${new Date().toTimeString().slice(0, 8)}\x1b[39m` : new Date().toTimeString().slice(0, 8)} ${text.replace(/https:\/\/github\.com\/([^/\s]+\/[^/\s]+)\/(?:issues|pull)\/(\d+)/g, (url, repo, number) => `\x1b]8;;${url}\x07\x1b[38;2;106;113;247m${repo}#${number}\x1b[39m\x1b]8;;\x07`)}`
     );
     if (view.depth > 0) {
       view.depth += wrap(notes.at(-1), stream.columns || 80).length;
@@ -74,7 +83,7 @@ export const tty = (stream, crew, status, legend) => {
   };
   return Object.freeze({
     row: (index) => row({ push: ([i, text]) => update(i, text) }, index),
-    notice: () => protocol({ push: ([level, text]) => note(level === 'warn' ? `\x1b[38;2;255;135;0m${text}\x1b[39m` : text) }),
+    notice: () => protocol({ push: ([level, text]) => note(level, text) }),
     up: () => {
       view.depth += 1;
       redraw();

package/src/wishes.js

@@ -15,8 +15,7 @@ export const wishes = (dir, interval, archive = '', pause = 0, notice = { warn:
     signal.throwIfAborted();
     const files = (await readdir(dir, { recursive: true, withFileTypes: true }))
       .filter((f) => f.isFile() && f.name.endsWith('.md'))
-      .map((f) => join(relative(dir, f.parentPath), f.name))
-      .sort();
+      .map((f) => join(relative(dir, f.parentPath), f.name));
     signal.throwIfAborted();
     if (startup.length === 0) {
       startup.push(new Set(files));
@@ -25,7 +24,8 @@ export const wishes = (dir, interval, archive = '', pause = 0, notice = { warn:
         notice.warn(`found ${count} pre-existing ${count === 1 ? 'wish' : 'wishes'} in ${dir} that ${count === 1 ? 'is' : 'are'} not permanent`);
       }
     }
-    const path = files.find((f) => !claims.has(f))
+    const fresh = files.filter((f) => !claims.has(f));
+    const path = fresh[Math.floor(Math.random() * fresh.length)]
       ?? [...claims.keys()].find((c) => !claims.get(c) && files.includes(c));
     if (path === undefined) {
       await setTimeout(interval, undefined, { signal });