geneseed 5.4.0 → 5.5.0
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.
- package/CHANGELOG.md +34 -0
- package/README.md +30 -0
- package/SHIPPED.md +1 -1
- package/adapters/bob/README.md +12 -1
- package/adapters/opencode/README.md +2 -1
- package/adapters/opencode/plugins/geneseed-context.js +71 -10
- package/adapters/opencode/plugins/geneseed-guard.js +101 -19
- package/adapters/opencode/plugins/geneseed-learn.js +641 -6
- package/bin/geneseed-cli.mjs +3 -0
- package/bin/geneseed-hook.mjs +2 -1
- package/docs/concepts/agents.md +13 -1
- package/docs/concepts/enforcement-table.md +1 -1
- package/docs/concepts/foreman-mode.md +22 -3
- package/docs/concepts/hook-gates.md +1 -1
- package/docs/concepts/hooks.md +22 -5
- package/docs/concepts/host-matrix.md +2 -2
- package/docs/concepts/hosts.md +1 -1
- package/docs/concepts/shared-tier.md +1 -1
- package/docs/concepts/skills.md +21 -1
- package/docs/concepts/themes.md +1 -1
- package/docs/extending.md +10 -1
- package/docs/guides/install-clone.md +18 -0
- package/docs/guides/install-scripted.md +8 -2
- package/docs/guides/install.md +19 -1
- package/docs/guides/upgrade.md +1 -1
- package/docs/reference/env-context.md +1 -1
- package/docs/reference/environment.md +1 -1
- package/docs/reference/plugin-learn.md +4 -0
- package/docs/reference/profiles.md +142 -0
- package/docs/token-footprint.md +9 -4
- package/docs/understand/design-choices-engineering.md +1 -1
- package/docs/web-ui.md +3 -1
- package/harness.config.json +1 -1
- package/js/README.md +9 -2
- package/js/build/args.mjs +4 -3
- package/js/build/catalog.mjs +11 -1
- package/js/build/driver.mjs +42 -11
- package/js/build/emit-claude.mjs +24 -1
- package/js/build/emit-opencode.mjs +3 -0
- package/js/build/export.mjs +1 -1
- package/js/build/generate.mjs +2 -1
- package/js/build/notes-migrate.mjs +99 -0
- package/js/build/profile.mjs +14 -6
- package/js/build/render.mjs +34 -10
- package/js/build/source.mjs +85 -2
- package/js/cli-table.json +164 -4
- package/js/hosts/agent-runs.mjs +205 -0
- package/js/hosts/done-checks.mjs +3 -1
- package/js/hosts/hooks-done.mjs +91 -16
- package/js/hosts/hooks-learn.mjs +85 -0
- package/js/hosts/hooks-prims.mjs +39 -1
- package/js/hosts/hooks.mjs +6 -3
- package/js/hosts/hosts.mjs +10 -0
- package/js/hosts/installs.mjs +25 -1
- package/js/hosts/link.mjs +45 -10
- package/js/hosts/native.mjs +42 -5
- package/js/hosts/opencode.mjs +1 -1
- package/js/hosts/settings.mjs +72 -0
- package/js/hosts/spec-feedback.mjs +538 -0
- package/js/hosts/usage.mjs +67 -8
- package/js/inspect/agent-scores.mjs +118 -0
- package/js/inspect/checks-authoring.mjs +2 -1
- package/js/inspect/checks-build.mjs +20 -4
- package/js/inspect/checks-repo.mjs +27 -2
- package/js/inspect/cost.mjs +6 -5
- package/js/inspect/diff.mjs +25 -5
- package/js/inspect/doctor.mjs +4 -0
- package/js/inspect/status.mjs +3 -1
- package/js/inspect/validate.mjs +1 -0
- package/js/lib/machine-dir.mjs +8 -0
- package/js/lib/paths.mjs +4 -1
- package/js/maintain/profile-scope.mjs +145 -0
- package/js/maintain/profiles.mjs +486 -0
- package/js/maintain/setup.mjs +409 -15
- package/js/maintain/uninstall.mjs +4 -1
- package/js/maintain/update.mjs +1 -1
- package/js/web/actions.mjs +28 -38
- package/js/web/api.mjs +7 -2
- package/js/web/handler.mjs +8 -0
- package/js/web/jobs.mjs +5 -4
- package/js/web/profiles-api.mjs +201 -0
- package/js/web/routes.mjs +5 -0
- package/package.json +2 -1
- package/profiles/guillaume-claude-global.json +16 -0
- package/profiles/starter.json +14 -0
- package/src/AGENT.md.tmpl +1 -1
- package/src/agents/_self-improvement.md +15 -7
- package/src/agents/_template.md +4 -2
- package/src/agents/advocate.md +1 -1
- package/src/agents/architect.md +1 -1
- package/src/agents/developer.md +10 -3
- package/src/agents/devops-engineer.md +1 -1
- package/src/agents/docker-expert.md +1 -1
- package/src/agents/docs.md +1 -1
- package/src/agents/empiricist.md +1 -1
- package/src/agents/explorer.md +4 -2
- package/src/agents/framer.md +1 -1
- package/src/agents/historian.md +1 -1
- package/src/agents/kubernetes-specialist.md +1 -1
- package/src/agents/memory-curator.md +1 -1
- package/src/agents/operator.md +1 -1
- package/src/agents/performance.md +1 -1
- package/src/agents/pragmatist.md +1 -1
- package/src/agents/react-engineer.md +1 -1
- package/src/agents/react-reviewer.md +1 -1
- package/src/agents/researcher.md +1 -1
- package/src/agents/reviewer.md +10 -3
- package/src/agents/security.md +1 -1
- package/src/agents/skeptic.md +1 -1
- package/src/agents/spring-boot-engineer.md +1 -1
- package/src/agents/spring-reviewer.md +1 -1
- package/src/agents/spring-security.md +1 -1
- package/src/agents/steward.md +1 -1
- package/src/agents/tester.md +4 -2
- package/src/agents/user-advocate.md +1 -1
- package/src/agents/visionary.md +1 -1
- package/src/memory/README.md +12 -2
- package/src/modes/foreman.md +23 -10
- package/src/skill-descriptions.json +63 -0
- package/src/skills/_self-improvement.md +42 -26
- package/src/skills/_template.md +3 -1
- package/src/skills/brainstorm.md +35 -22
- package/src/skills/daydream/VENDOR.md +6 -0
- package/src/skills/diagram-design/VENDOR.md +4 -0
- package/src/skills/explain-changes/VENDOR.md +5 -1
- package/src/skills/parallel-agents.md +11 -0
- package/src/skills/pipeline.md +3 -3
- package/src/skills/plan.md +5 -4
- package/src/skills/react-view-transitions/VENDOR.md +7 -1
- package/src/skills/release.md +7 -2
- package/src/skills/rule/approve.md +2 -1
- package/src/skills/skill-forge.md +5 -3
- package/src/skills/token-report/VENDOR.md +5 -1
- package/src/upstreams.json +2 -2
- package/themes/README.md +3 -1
- package/web/dist/assets/{ActiveLoops-BJJN3P-V.js → ActiveLoops-DOJCPPPc.js} +1 -1
- package/web/dist/assets/{Activity-D2kOc3yi.js → Activity-LKsDzsnK.js} +1 -1
- package/web/dist/assets/{ActivityDetail-By3xOr21.js → ActivityDetail-DhwTfPm6.js} +1 -1
- package/web/dist/assets/{Bonsai-CBWDTBA4.js → Bonsai-CePMLrpr.js} +1 -1
- package/web/dist/assets/{CopyButton-BVbpriMB.js → CopyButton-CuoaJ6k7.js} +1 -1
- package/web/dist/assets/{Dashboard-CIJLPHM9.js → Dashboard-D1VKuvLe.js} +2 -2
- package/web/dist/assets/{Docs-CiRRIELs.js → Docs-CUrHJKaU.js} +1 -1
- package/web/dist/assets/{Factories-DhyK0O8d.js → Factories-Ci1XfmSy.js} +1 -1
- package/web/dist/assets/{GreenhouseView-DW3PgTPy.js → GreenhouseView-CNfH2lPK.js} +1 -1
- package/web/dist/assets/Installs-ZHQZM1iS.js +3 -0
- package/web/dist/assets/{JournalView-O65qEWfp.js → JournalView-CMsWahkS.js} +1 -1
- package/web/dist/assets/{Kits-C5U-yT6Z.js → Kits-CkliyK0n.js} +1 -1
- package/web/dist/assets/{Laws-CuTw_XNf.js → Laws-hh4O3HZ4.js} +1 -1
- package/web/dist/assets/{LibRows-D6-CVa3K.js → LibRows-Brv0Hmkr.js} +1 -1
- package/web/dist/assets/{Library-CzPlerd6.js → Library-BYmiLjJr.js} +1 -1
- package/web/dist/assets/{Loops-CqNF_-nS.js → Loops-ytm-xJ68.js} +1 -1
- package/web/dist/assets/{OperatorHudView-BNr8K5qj.js → OperatorHudView-KaqCx_HP.js} +1 -1
- package/web/dist/assets/{Personal-DeDb9e8O.js → Personal-CmcnRKYE.js} +1 -1
- package/web/dist/assets/{Settings-B8MPN_AD.js → Settings-tUrpdOfq.js} +1 -1
- package/web/dist/assets/{Tabs-DJzAez4h.js → Tabs-CD7etcGD.js} +1 -1
- package/web/dist/assets/api-CZ-x0iWG.js +1 -0
- package/web/dist/assets/{controls-D4wmg_pl.js → controls-CK7qHA8H.js} +1 -1
- package/web/dist/assets/{index-CRWqKxfY.css → index-Ba_Kg3Af.css} +1 -1
- package/web/dist/assets/{index-BL3P-9Rg.js → index-COKbhFNo.js} +3 -3
- package/web/dist/index.html +3 -3
- package/web/dist/assets/Installs-B6nlo-Ly.js +0 -3
- package/web/dist/assets/api-DLDVY3K-.js +0 -1
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The project notes, moved to their one folder (the owner's ruling, 2026-11-15).
|
|
3
|
+
*
|
|
4
|
+
* Before the two scopes, a PROJECT install kept every spec-feedback note in its own notebook,
|
|
5
|
+
* which differs per host: `.claude/notebook`, `.bob/notebook`, `.openclaude/notebook`, and
|
|
6
|
+
* `.opencode/notebook` for an OpenCode install older than #590. Those notes were written with no
|
|
7
|
+
* scope, so each counts as a PROJECT note now: on the next emit of that install they are merged
|
|
8
|
+
* into `<project>/notebook/{agent,skill}-notes/`, the one folder every host's step 0 reads.
|
|
9
|
+
*
|
|
10
|
+
* NO LOSS, BY CONSTRUCTION. The merge has no cap (`mergeNotesText`: a line the target already holds
|
|
11
|
+
* exactly is not added twice, and nothing is dropped), the target is read back and must hold every
|
|
12
|
+
* line of the source before the source moves, and the source then moves aside into
|
|
13
|
+
* `<project>/notebook/archived-<sub>/<stamp>/`, beside the target so a removed worktree cannot take
|
|
14
|
+
* the backup with it, as the fold sets a host store aside: never unlinked. A file
|
|
15
|
+
* that cannot be merged (not UTF-8 on either side, a read or write that fails) stays where it was,
|
|
16
|
+
* named in one line. A global install's notebook is the fold's (js/build/fold.mjs `foldNotes`), and
|
|
17
|
+
* a second emit finds nothing to move.
|
|
18
|
+
*/
|
|
19
|
+
import { isUtf8 } from 'node:buffer';
|
|
20
|
+
import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmdirSync, statSync, writeFileSync } from 'node:fs';
|
|
21
|
+
import path from 'node:path';
|
|
22
|
+
import { NOTES_DIRS } from '../lib/machine-dir.mjs';
|
|
23
|
+
import { normcase } from '../lib/paths.mjs';
|
|
24
|
+
import { relPosix } from '../lib/text.mjs';
|
|
25
|
+
import { archiveStore } from '../hosts/memory-files.mjs';
|
|
26
|
+
import {
|
|
27
|
+
excludeProjectNotes, mergeNotesText, projectNotesDir, withLock,
|
|
28
|
+
} from '../hosts/spec-feedback.mjs';
|
|
29
|
+
|
|
30
|
+
const isFile = (p) => { try { return statSync(p).isFile(); } catch { return false; } };
|
|
31
|
+
const readUtf8 = (p) => {
|
|
32
|
+
const raw = readFileSync(p);
|
|
33
|
+
if (!isUtf8(raw)) throw new Error('not UTF-8');
|
|
34
|
+
return raw.toString('utf8');
|
|
35
|
+
};
|
|
36
|
+
// Every line of a note, exact (a CR aside): what the read-back compares.
|
|
37
|
+
const linesOf = (text) => new Set(text.replace(/\r\n?/g, '\n').split('\n').filter((l) => l.trim()));
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Merge `<cfgDir>/notebook/{agent,skill}-notes/*.md` into `<projectRoot>/notebook/…`. Returns
|
|
41
|
+
* `{ moved, kept, archived }`: the files merged and set aside, the files left in place with why,
|
|
42
|
+
* and where the moved ones went. Prints one line when it moved anything and one per file it kept.
|
|
43
|
+
*/
|
|
44
|
+
export function migrateProjectNotes(cfgDir, projectRoot, say = (s) => process.stdout.write(s)) {
|
|
45
|
+
const report = { moved: [], kept: [], archived: [] };
|
|
46
|
+
// A linked worktree's notes go to its main checkout, as the hook writes them (`projectNotesDir`).
|
|
47
|
+
const target = projectNotesDir(projectRoot);
|
|
48
|
+
for (const sub of NOTES_DIRS) {
|
|
49
|
+
const src = path.join(cfgDir, 'notebook', sub);
|
|
50
|
+
const dst = path.join(target, sub);
|
|
51
|
+
if (normcase(path.resolve(src)) === normcase(path.resolve(dst))) continue;
|
|
52
|
+
let names;
|
|
53
|
+
try { names = readdirSync(src).filter((n) => n.endsWith('.md') && isFile(path.join(src, n))).sort(); } catch { continue; }
|
|
54
|
+
const merged = [];
|
|
55
|
+
for (const name of names) {
|
|
56
|
+
const from = path.join(src, name);
|
|
57
|
+
const to = path.join(dst, name);
|
|
58
|
+
const rel = relPosix(projectRoot, from) || from;
|
|
59
|
+
try {
|
|
60
|
+
const text = readUtf8(from);
|
|
61
|
+
mkdirSync(dst, { recursive: true });
|
|
62
|
+
// Under the capture's own lock: a hook may be adding a note to the same file right now.
|
|
63
|
+
const done = withLock(to, () => {
|
|
64
|
+
const next = mergeNotesText(existsSync(to) ? readUtf8(to) : '', text);
|
|
65
|
+
if (next !== null) writeFileSync(to, next, 'utf8');
|
|
66
|
+
return true;
|
|
67
|
+
});
|
|
68
|
+
if (done !== true) throw new Error('the notes file stayed locked');
|
|
69
|
+
const have = linesOf(readUtf8(to));
|
|
70
|
+
if ([...linesOf(text)].some((l) => !have.has(l))) throw new Error(`${relPosix(projectRoot, to)} does not hold every line`);
|
|
71
|
+
merged.push(name);
|
|
72
|
+
} catch (e) {
|
|
73
|
+
report.kept.push({ rel, why: e.message });
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
if (merged.length) {
|
|
77
|
+
// Beside the merge target, not the source: in a linked worktree the source goes with the
|
|
78
|
+
// worktree, and the backup must outlive it.
|
|
79
|
+
const dest = archiveStore(src, (_store, into) => {
|
|
80
|
+
mkdirSync(into, { recursive: true });
|
|
81
|
+
for (const name of merged) renameSync(path.join(src, name), path.join(String(into), name));
|
|
82
|
+
}, path.join(target, `archived-${sub}`));
|
|
83
|
+
report.archived.push(dest);
|
|
84
|
+
report.moved.push(...merged.map((n) => `${sub}/${n}`));
|
|
85
|
+
try { rmdirSync(src); } catch { /* not empty: a kept file, or one that is not a note */ }
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
if (report.moved.length) {
|
|
89
|
+
// The notes and their archives stay out of every commit (`.git/info/exclude`, per clone).
|
|
90
|
+
excludeProjectNotes(target);
|
|
91
|
+
say(`[geneseed] notes: merged ${report.moved.length} project note file(s) from `
|
|
92
|
+
+ `${relPosix(projectRoot, path.join(cfgDir, 'notebook')) || cfgDir} into ${relPosix(projectRoot, target) || target}/; the originals `
|
|
93
|
+
+ `are set aside in ${report.archived.map((a) => relPosix(projectRoot, a) || a).join(', ')}\n`);
|
|
94
|
+
}
|
|
95
|
+
for (const { rel, why } of report.kept) {
|
|
96
|
+
say(`[geneseed] notes: kept ${rel} where it is, not merged into ${relPosix(projectRoot, target) || target}/ (${why}); merge it by hand\n`);
|
|
97
|
+
}
|
|
98
|
+
return report;
|
|
99
|
+
}
|
package/js/build/profile.mjs
CHANGED
|
@@ -11,11 +11,11 @@
|
|
|
11
11
|
import { existsSync } from 'node:fs';
|
|
12
12
|
import path from 'node:path';
|
|
13
13
|
|
|
14
|
-
import { GATE_SWITCHES, PACK_ORDER } from './source.mjs';
|
|
14
|
+
import { DEFAULT_CONTEXT_WINDOW, GATE_SWITCHES, PACK_ORDER } from './source.mjs';
|
|
15
15
|
import { DEFAULT_PRESET } from '../loop/score.mjs';
|
|
16
16
|
import { CLAUDE_STYLE, GLOBAL_MANIFEST, HOSTS } from '../hosts/hosts.mjs';
|
|
17
17
|
import {
|
|
18
|
-
EMIT_FOR, EMIT_HOST_SCOPE, defaultMode, defaultPosture, defaultTheme, doctrinesForBuild,
|
|
18
|
+
EMIT_FOR, EMIT_HOST_SCOPE, contextWindowOfDir, defaultMode, defaultPosture, defaultTheme, doctrinesForBuild,
|
|
19
19
|
emitHostScopeOf, excludedRulesOfDir, excludedSkillsOfDir, footprintOfDir, kitsOfDir, sharedTierOfDir,
|
|
20
20
|
gatesOfDir, installState, modeOfDir, postureOfDir, readMaybe, themeOfDir, trustOfDir,
|
|
21
21
|
} from '../hosts/installs.mjs';
|
|
@@ -55,7 +55,8 @@ import {
|
|
|
55
55
|
*/
|
|
56
56
|
export function setupBuildArgs(theme, emit, out = null, root = null, footprint = 'lean',
|
|
57
57
|
posture = 'peer', mode = 'direct', doctrines = null, allPacks = PACK_ORDER,
|
|
58
|
-
excludeRules = null, trust = DEFAULT_PRESET, excludeSkills = null, gates = {}, kits = null, sharedTier = false
|
|
58
|
+
excludeRules = null, trust = DEFAULT_PRESET, excludeSkills = null, gates = {}, kits = null, sharedTier = false,
|
|
59
|
+
contextWindow = DEFAULT_CONTEXT_WINDOW) {
|
|
59
60
|
const argv = ['--theme', theme, '--emit', emit];
|
|
60
61
|
if (!emit.endsWith('-global')) {
|
|
61
62
|
if (out) argv.push('--out', out);
|
|
@@ -93,6 +94,9 @@ export function setupBuildArgs(theme, emit, out = null, root = null, footprint =
|
|
|
93
94
|
if (kits?.length) argv.push('--kits', [...kits].sort().join(','));
|
|
94
95
|
// The shared tier elides when off, like the kits: the default is off, so only `on` speaks.
|
|
95
96
|
if (sharedTier) argv.push('--shared-tier', 'on');
|
|
97
|
+
// The context window elides at its default, like the shared tier: no config key feeds it, so
|
|
98
|
+
// only `1m` speaks and every default argv stays the bytes it was before the flag existed.
|
|
99
|
+
if (contextWindow && contextWindow !== DEFAULT_CONTEXT_WINDOW) argv.push('--context-window', contextWindow);
|
|
96
100
|
return argv;
|
|
97
101
|
}
|
|
98
102
|
|
|
@@ -150,9 +154,11 @@ export function installProfile(host, scope, root, notify = null) {
|
|
|
150
154
|
const kits = kitsOfDir(root, host, notify);
|
|
151
155
|
// A project install's `Shared tier: on` stays on across a rebuild; a global install never has it.
|
|
152
156
|
const sharedTier = sharedTierOfDir(root, host);
|
|
157
|
+
// `Context window: 1m` stays 1m: a rebuild that forgot it would shrink the listing cap.
|
|
158
|
+
const contextWindow = contextWindowOfDir(root, host);
|
|
153
159
|
const out = scope === 'global' ? null : root;
|
|
154
160
|
const argv = setupBuildArgs(theme, emit, out, out, footprint, posture, mode, doctrines,
|
|
155
|
-
PACK_ORDER, excludeRules, trust, excludeSkills, gates, kits, sharedTier);
|
|
161
|
+
PACK_ORDER, excludeRules, trust, excludeSkills, gates, kits, sharedTier, contextWindow);
|
|
156
162
|
// A GLOBAL ROW NAMES ITS OWN DIR. `root` came from the host's config-dir resolver, which
|
|
157
163
|
// honours env overrides (`OPENCODE_CONFIG_DIR`, `CLAUDE_CONFIG_DIR`…); without the flag the
|
|
158
164
|
// same argv run from a shell lacking that variable re-emits into the DEFAULT dir — a second
|
|
@@ -161,7 +167,7 @@ export function installProfile(host, scope, root, notify = null) {
|
|
|
161
167
|
return {
|
|
162
168
|
host, scope, root, state: installState(root, host, scope),
|
|
163
169
|
emit, theme, footprint, posture, mode, trust, doctrines, excludeRules, excludeSkills,
|
|
164
|
-
kits, sharedTier, ...gates, argv,
|
|
170
|
+
kits, sharedTier, contextWindow, ...gates, argv,
|
|
165
171
|
};
|
|
166
172
|
}
|
|
167
173
|
|
|
@@ -204,6 +210,8 @@ const GUARDED = [
|
|
|
204
210
|
{ name: 'kits', given: 'kits', flag: '--kits', now: (a) => show(sorted(a.kits)), was: (p) => show(sorted(p.kits)) },
|
|
205
211
|
{ name: 'shared-tier', given: 'sharedTier', flag: '--shared-tier',
|
|
206
212
|
now: (a) => (a.sharedTier === 'on' ? 'on' : 'off'), was: (p) => (p.sharedTier ? 'on' : 'off') },
|
|
213
|
+
{ name: 'context-window', given: 'contextWindow', flag: '--context-window',
|
|
214
|
+
now: (a) => a.contextWindow ?? DEFAULT_CONTEXT_WINDOW, was: (p) => p.contextWindow },
|
|
207
215
|
// A switch reads as its flag says. `--no-deletion-gate` given is `deletion-gate: off`;
|
|
208
216
|
// `--strict-consent` (the one switch whose flag adds asks, so it is not `--no-*`) given is
|
|
209
217
|
// `strict-consent: on`. Either way the flag given means the switch's key is `false`.
|
|
@@ -236,7 +244,7 @@ function givenTokens(row, args) {
|
|
|
236
244
|
* before it is ours, and the guard must never refuse a first install into a repo that already
|
|
237
245
|
* uses OpenCode.
|
|
238
246
|
*/
|
|
239
|
-
function guardTarget(args, out) {
|
|
247
|
+
export function guardTarget(args, out) {
|
|
240
248
|
if (args.emit === 'files') return null;
|
|
241
249
|
const [host, scope] = EMIT_HOST_SCOPE.get(args.emit) ?? [];
|
|
242
250
|
if (!host) return null;
|
package/js/build/render.mjs
CHANGED
|
@@ -37,8 +37,11 @@ import { normcase, comparePaths } from '../lib/paths.mjs';
|
|
|
37
37
|
import {
|
|
38
38
|
CREDIT_RE, GATE_SWITCHES, PACK_ORDER, kitMembers, loadKits, readPackText, resolveCredits, resolveRuleIds, ruleCanon, titleKey, upstreamOf,
|
|
39
39
|
} from './source.mjs';
|
|
40
|
+
import { CONTEXT_WINDOW_MARKER, DEFAULT_CONTEXT_WINDOW } from './source.mjs';
|
|
40
41
|
import { SHARED_TIER_LINE } from '../hosts/hosts.mjs';
|
|
41
|
-
import {
|
|
42
|
+
import { PROJECT_NOTES_DIR } from '../hosts/spec-feedback.mjs';
|
|
43
|
+
import { PORTABLE_MACHINE_DIR } from '../lib/machine-dir.mjs';
|
|
44
|
+
import { VENDORED_SKILL_DIRS, vendoredWithCatalogueLine } from '../hosts/native.mjs';
|
|
42
45
|
import { DEFAULT_PRESET } from '../loop/score.mjs';
|
|
43
46
|
|
|
44
47
|
/** Document STRUCTURE is theme-INDEPENDENT — mirrors `_build_render.STRUCTURE`. */
|
|
@@ -72,7 +75,11 @@ export function pathTokens(theme, sharedRoot = null) {
|
|
|
72
75
|
const at = sharedRoot ? `${sharedRoot}/` : theme.AT_HARNESS ?? '';
|
|
73
76
|
return {
|
|
74
77
|
PATH_MEMORY: sharedRoot ? `${at}memory` : memory,
|
|
75
|
-
|
|
78
|
+
// The two notes scopes (js/hosts/spec-feedback.mjs `PROJECT_NOTES_DIR`). Machine: the tier,
|
|
79
|
+
// absolute on a global emit, the portable `~` form on any other (a project's files travel).
|
|
80
|
+
// Project: relative to the project root, the same on every host and never prefixed.
|
|
81
|
+
PATH_NOTES: `${sharedRoot ?? PORTABLE_MACHINE_DIR}/notes`,
|
|
82
|
+
PATH_PROJECT_NOTES: PROJECT_NOTES_DIR,
|
|
76
83
|
PATH_RULES: `${at}user-rules.md`,
|
|
77
84
|
PATH_PROFILE: `${at}PROFILE.md`,
|
|
78
85
|
PATH_WIKI: `${at}geneseed-wiki.jsonc`,
|
|
@@ -95,9 +102,10 @@ export const SRC_DIR_TOKENS = {
|
|
|
95
102
|
};
|
|
96
103
|
|
|
97
104
|
const TEXT_SUFFIXES = new Set(['.md', '.tmpl', '.json', '.txt', '.yml', '.yaml']);
|
|
98
|
-
/** Top-level `src/` entries the build reads but never ships: upstream-credit provenance,
|
|
99
|
-
* kit manifests (a kit's members ship flat from `skills/` and `agents/`)
|
|
100
|
-
|
|
105
|
+
/** Top-level `src/` entries the build reads but never ships: upstream-credit provenance, the
|
|
106
|
+
* kit manifests (a kit's members ship flat from `skills/` and `agents/`), and the skill
|
|
107
|
+
* catalogue lines (they ship inside each skill's frontmatter, `skillDescription`). */
|
|
108
|
+
const NOT_BUNDLED = new Set(['upstreams.json', 'licenses', 'kits', 'skill-descriptions.json']);
|
|
101
109
|
|
|
102
110
|
// Digits are legal after the first character: `DOC_<PACK>_<n>` (the doctrine rule titles) are
|
|
103
111
|
// the first token names in the project to carry one, and without `0-9` here `{{DOC_CRAFT_1}}`
|
|
@@ -397,6 +405,12 @@ function readSource(cfg, p) {
|
|
|
397
405
|
return text;
|
|
398
406
|
}
|
|
399
407
|
|
|
408
|
+
/** A skill spec's id, `skills/<id>.md` (a `_` file is a partial, not a skill), else null. */
|
|
409
|
+
function skillIdOf(file) {
|
|
410
|
+
const stem = path.basename(file, '.md');
|
|
411
|
+
return path.basename(path.dirname(file)) === 'skills' && file.endsWith('.md') && !stem.startsWith('_') ? stem : null;
|
|
412
|
+
}
|
|
413
|
+
|
|
400
414
|
/**
|
|
401
415
|
* `_build_render.render_file`.
|
|
402
416
|
*
|
|
@@ -424,6 +438,11 @@ export function renderFile(cfg, filePath, theme, footprint = 'full', lawsPrefix
|
|
|
424
438
|
.replace(/\n+$/, ''); // `.rstrip("\n")`
|
|
425
439
|
});
|
|
426
440
|
|
|
441
|
+
// A skill's own id, for the notes path and the feedback tag its self-improvement include names
|
|
442
|
+
// (src/skills/_self-improvement.md): literal, so the model never guesses it from an alias it
|
|
443
|
+
// was run under. On the top-level file only, once the includes are flattened into it; any
|
|
444
|
+
// other file (the include itself, the template) keeps the `<name>` placeholder.
|
|
445
|
+
if (!visiting.size) text = text.replaceAll('{{SKILL_NAME}}', skillIdOf(here) ?? '<name>');
|
|
427
446
|
text = resolveCatalogs(text, nativeCatalog, cfg.excludeSkills ?? [], cfg);
|
|
428
447
|
text = resolveLean(text, footprint);
|
|
429
448
|
if (footprint === 'lean') text = leanVoice(text, cfg.src);
|
|
@@ -627,12 +646,10 @@ export function effectiveTheme(cfg, themeName, {
|
|
|
627
646
|
footprint = 'full', lawsPrefix = '', sharedRoot = null,
|
|
628
647
|
} = {}) {
|
|
629
648
|
const theme = { ...loadTheme(cfg, themeName), ...(cfg.structure ?? STRUCTURE) };
|
|
649
|
+
// Neither notes path takes `lawsPrefix`: the machine one is the tier's, and the project one is
|
|
650
|
+
// the project root's `notebook/` on every host. Prefixing it once sent OpenClaude's skills to
|
|
651
|
+
// `notebook/` while its hook wrote `.openclaude/notebook/` (T10).
|
|
630
652
|
Object.assign(theme, pathTokens(theme, sharedRoot));
|
|
631
|
-
// A skill or agent names its notes file as a path the agent opens from the project root, and
|
|
632
|
-
// on an install whose harness sits a level down (`.claude/`) the notebook is there too. Only
|
|
633
|
-
// the relative form takes the prefix; the root file's re-render (`prefixedAgentText`) derives
|
|
634
|
-
// its own from its prefixed DIR_NOTEBOOK.
|
|
635
|
-
if (!sharedRoot) theme.PATH_NOTES = `${lawsPrefix}${theme.PATH_NOTES}`;
|
|
636
653
|
// Empty without a tier, so a project emit and a default build stay byte-identical (the
|
|
637
654
|
// `EXCLUDED_SKILLS_LINE` contract). Each rides the end of a template line, so its value carries
|
|
638
655
|
// the blank line. C1 lives in this text: the readers only concatenate, shared first.
|
|
@@ -689,6 +706,9 @@ export function effectiveTheme(cfg, themeName, {
|
|
|
689
706
|
// The shared-tier marker, under the same contract (`sharedTierOfDir` reads it): written only when
|
|
690
707
|
// `on`, so a default build stays byte-identical. Not `GATE_SWITCHES`, which holds `--no-*` disarms.
|
|
691
708
|
theme.SHARED_TIER_LINE = cfg.sharedTier ? `\n${SHARED_TIER_LINE}\n` : '';
|
|
709
|
+
// `--context-window`, under the same contract (`contextWindowOfDir` reads it): a line only off the default.
|
|
710
|
+
theme.CONTEXT_WINDOW_LINE = cfg.contextWindow && cfg.contextWindow !== DEFAULT_CONTEXT_WINDOW
|
|
711
|
+
? `\n${CONTEXT_WINDOW_MARKER}: ${cfg.contextWindow}\n` : '';
|
|
692
712
|
// The gate switches (`GATE_SWITCHES`: Laws I, III, IV), under the same contract: a line is
|
|
693
713
|
// written only when its gate is OFF, so a default build stays byte-identical and a missing
|
|
694
714
|
// line reads back as armed (`gatesOfDir`). The OpenCode plugins read these lines at load, so
|
|
@@ -774,6 +794,10 @@ export function renderAll(cfg, themeName, {
|
|
|
774
794
|
const fp = /^(?:laws|ontology|doctrines)[\\/]/.test(rel) ? 'full' : footprint;
|
|
775
795
|
let text = TEXT_SUFFIXES.has(suffixOf(path.basename(file)))
|
|
776
796
|
? renderFile(cfg, file, theme, fp, lawsPrefix, new Set(), nativeCatalog) : null;
|
|
797
|
+
// A vendored skill's listed description is our catalogue line, on every host and in the
|
|
798
|
+
// bundle; here, once, so no writer applies it twice.
|
|
799
|
+
if (text !== null && sp[0] === 'skills' && sp.length === 3 && sp[2] === 'SKILL.md'
|
|
800
|
+
&& VENDORED_SKILL_DIRS.has(sp[1])) text = vendoredWithCatalogueLine(text, sp[1], cfg.src);
|
|
777
801
|
items.push({ rel: outRel, text, src: file });
|
|
778
802
|
// A credited skill ships its upstream's licence beside it, one copy per (skill, key). The
|
|
779
803
|
// token is gone from `text`, so the raw source is scanned; an unknown key or a null
|
package/js/build/source.mjs
CHANGED
|
@@ -253,6 +253,35 @@ export function upstreams(src = SRC) {
|
|
|
253
253
|
return entries;
|
|
254
254
|
}
|
|
255
255
|
|
|
256
|
+
/**
|
|
257
|
+
* The longest model-visible skill description, in characters. Claude Code lists skills under
|
|
258
|
+
* a budget of about 1% of the context window (some 6 000 characters on a 200k model) and,
|
|
259
|
+
* when the listing overruns it, drops the descriptions of the least-used skills first; a fresh
|
|
260
|
+
* install has no usage history, so every long description is at risk. 80 characters keeps the
|
|
261
|
+
* whole default catalogue far inside that budget, purpose and trigger both.
|
|
262
|
+
*/
|
|
263
|
+
export const DESCRIPTION_LIMIT = 80;
|
|
264
|
+
|
|
265
|
+
const _descriptions = new Map();
|
|
266
|
+
/**
|
|
267
|
+
* `src/skill-descriptions.json` — skill stem -> its catalogue line, the ONE home of the
|
|
268
|
+
* `description:` every host's model routes on (`skillDescription`). Theme-neutral on purpose:
|
|
269
|
+
* the themed purpose of each skill still opens its body (`{{DESC_*}}`), but the frontmatter
|
|
270
|
+
* line has to fit `DESCRIPTION_LIMIT`, which no themed purpose plus trigger did (the user
|
|
271
|
+
* reversed the 2026-11-11 themed-catalogue decision for this line only, 2026-11-15).
|
|
272
|
+
* Memoised on the raw text, as `upstreams` is. A tree without the file has no lines.
|
|
273
|
+
*/
|
|
274
|
+
export function skillDescriptions(src = SRC) {
|
|
275
|
+
const file = path.join(src, 'skill-descriptions.json');
|
|
276
|
+
let text;
|
|
277
|
+
try { text = readFileSync(file, 'utf8'); } catch { return {}; }
|
|
278
|
+
const hit = _descriptions.get(file);
|
|
279
|
+
if (hit && hit.text === text) return hit.entries;
|
|
280
|
+
const entries = JSON.parse(text);
|
|
281
|
+
_descriptions.set(file, { text, entries });
|
|
282
|
+
return entries;
|
|
283
|
+
}
|
|
284
|
+
|
|
256
285
|
/** The entry a credit key names, or null — `hasOwn`, so `constructor` is not a key. */
|
|
257
286
|
export function upstreamOf(key, src = SRC) {
|
|
258
287
|
const u = upstreams(src);
|
|
@@ -504,7 +533,23 @@ export function aliasesOf(text) {
|
|
|
504
533
|
return m ? m[1].split(',').map((s) => s.trim()).filter(Boolean) : [];
|
|
505
534
|
}
|
|
506
535
|
|
|
507
|
-
/**
|
|
536
|
+
/**
|
|
537
|
+
* Aliases taken OUT of a spec's marker -> the skill they used to alias. No emit writes them any
|
|
538
|
+
* more (the emitters read the marker, `aliasesOf`), but everything that reads an OLDER install
|
|
539
|
+
* still must: an `Excluded skills:` line that names one, and the alias folder an older build
|
|
540
|
+
* rendered, whose heading names the former target (`isRendered`, `staleRetired`). So
|
|
541
|
+
* `skillAliases` serves them beside the live markers, and the old render is moved aside like any
|
|
542
|
+
* retired alias's. `grill-me` left `brainstorm` because the user keeps a grill-me skill of
|
|
543
|
+
* their own, and an alias folder under that name collides with it.
|
|
544
|
+
*/
|
|
545
|
+
export const RETIRED_ALIASES = {
|
|
546
|
+
'grill-me': 'brainstorm',
|
|
547
|
+
};
|
|
548
|
+
|
|
549
|
+
/**
|
|
550
|
+
* Every declared alias -> the skill that declares it, then each `RETIRED_ALIASES` entry no
|
|
551
|
+
* marker declares. First declaration wins; the doctor names a duplicate.
|
|
552
|
+
*/
|
|
508
553
|
export function skillAliases(src = SRC) {
|
|
509
554
|
const map = new Map();
|
|
510
555
|
const dir = path.join(src, 'skills');
|
|
@@ -513,6 +558,7 @@ export function skillAliases(src = SRC) {
|
|
|
513
558
|
if (!map.has(a)) map.set(a, f.slice(0, -3));
|
|
514
559
|
}
|
|
515
560
|
}
|
|
561
|
+
for (const [a, target] of Object.entries(RETIRED_ALIASES)) if (!map.has(a)) map.set(a, target);
|
|
516
562
|
return map;
|
|
517
563
|
}
|
|
518
564
|
|
|
@@ -600,6 +646,41 @@ export const GATE_SWITCHES = [
|
|
|
600
646
|
{ key: 'ownBranchPass', flag: '--strict-consent', arg: 'strictConsent', marker: 'Own-branch pass', law: null },
|
|
601
647
|
];
|
|
602
648
|
|
|
649
|
+
/**
|
|
650
|
+
* `--context-window 200k|1m`: the model context the install is built for, and the Claude Code
|
|
651
|
+
* settings it writes for the skill listing. ONE table, so the flag, the carrier marker, the
|
|
652
|
+
* rebuild argv, the profile and the console read the same two values.
|
|
653
|
+
*
|
|
654
|
+
* WHY. Claude Code builds its skill listing under a character budget: context window x bytes
|
|
655
|
+
* per token (3, or 4 for some older models) x `skillListingBudgetFraction` (default 0.01). That
|
|
656
|
+
* is about 6 000 characters on a 200k model and 30 000 on a 1M one. Over budget, a skill with
|
|
657
|
+
* low usage loses its description, so a fresh install on a 200k model listed none of
|
|
658
|
+
* Geneseed's descriptions (measured 2026-11-15: a fresh neutral emit plus the 14 bundled skills
|
|
659
|
+
* is 11 482 characters at the default 1 536-character cap, the bundled skills' long texts most
|
|
660
|
+
* of it, even with Geneseed's own lines at 80 characters or less).
|
|
661
|
+
*
|
|
662
|
+
* THE VALUES (simulated 2026-11-15 on a fresh emit, no usage; the docs keep the table):
|
|
663
|
+
* - `200k`: `skillListingMaxDescChars` 80 fits all 46 descriptions in 5 605 of 6 000
|
|
664
|
+
* characters. That 395-character slack is too thin: with one shipped kit (spring-boot) it is
|
|
665
|
+
* 113, and five third-party skills push descriptions out. `skillListingBudgetFraction` 0.013
|
|
666
|
+
* (7 800 characters) keeps all of them with twenty third-party skills beside them. The
|
|
667
|
+
* fraction is a ceiling, not a cost: a listing that fits uses only its own length, so the
|
|
668
|
+
* extra 1 800 characters (about 600 tokens, 0.3 % of the window) are spent only when filled.
|
|
669
|
+
* - `1m`: a fresh install fits even at the default cap (11 482 of 30 000), so the fraction stays
|
|
670
|
+
* at its default. The cap 120 is for a machine with many skills: this laptop's 143-skill
|
|
671
|
+
* listing (47 617 characters) fits whole at 19 427 with it, where today 53 lose their text.
|
|
672
|
+
*
|
|
673
|
+
* Claude Code only: OpenClaude (checked on 0.31) and Bob read neither key, and OpenCode does
|
|
674
|
+
* not cap its list. Those emits record the choice and write nothing.
|
|
675
|
+
*/
|
|
676
|
+
export const CONTEXT_WINDOWS = Object.freeze({
|
|
677
|
+
'200k': Object.freeze({ skillListingMaxDescChars: 80, skillListingBudgetFraction: 0.013 }),
|
|
678
|
+
'1m': Object.freeze({ skillListingMaxDescChars: 120 }),
|
|
679
|
+
});
|
|
680
|
+
export const DEFAULT_CONTEXT_WINDOW = '200k';
|
|
681
|
+
/** The carrier marker, written only when the value is not the default (the kits line's contract). */
|
|
682
|
+
export const CONTEXT_WINDOW_MARKER = 'Context window';
|
|
683
|
+
|
|
603
684
|
/**
|
|
604
685
|
* `_build_core.js_cfg()`, originated rather than received.
|
|
605
686
|
*
|
|
@@ -615,7 +696,7 @@ export const GATE_SWITCHES = [
|
|
|
615
696
|
export function makeCfg({
|
|
616
697
|
posture = 'peer', mode = 'direct', trust = DEFAULT_PRESET, doctrines = PACK_ORDER,
|
|
617
698
|
excludeRules = [], excludeSkills = [], kits = [], sharedTier = /** @type {boolean | string} */ (false),
|
|
618
|
-
pruneGates = false, force = false, ...switches
|
|
699
|
+
contextWindow = DEFAULT_CONTEXT_WINDOW, pruneGates = false, force = false, ...switches
|
|
619
700
|
} = {}) {
|
|
620
701
|
return {
|
|
621
702
|
root: ROOT,
|
|
@@ -647,6 +728,8 @@ export function makeCfg({
|
|
|
647
728
|
kits: Array.isArray(kits) ? [...kits] : [],
|
|
648
729
|
// The shared tier read by a PROJECT install (`--shared-tier on`); `on` from the flag, a boolean from a read-back.
|
|
649
730
|
sharedTier: sharedTier === true || sharedTier === 'on',
|
|
731
|
+
// The context window the install is built for (`CONTEXT_WINDOWS`); anything unknown is the default.
|
|
732
|
+
contextWindow: Object.hasOwn(CONTEXT_WINDOWS, contextWindow) ? contextWindow : DEFAULT_CONTEXT_WINDOW,
|
|
650
733
|
// `--force`, for this one build: only a literal `true` forces. Never an axis of the install.
|
|
651
734
|
force: force === true,
|
|
652
735
|
// The gate switches (`GATE_SWITCHES`: `secretsGate`, `doneGate`, `deletionGate`), each armed
|
package/js/cli-table.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"commands": [
|
|
4
4
|
{
|
|
5
5
|
"name": "activity",
|
|
6
|
-
"help": "UserPromptSubmit/SessionEnd hook: records the session into <root>/activity/ for the web console's live view
|
|
6
|
+
"help": "UserPromptSubmit/SessionEnd hook: records the session into <root>/activity/ for the web console's live view (off with $GENESEED_ACTIVITY=off or the console toggle), and counts a typed /<skill> into <root>/notebook/usage.jsonl (off with $GENESEED_NO_USAGE or .usage-off); decides nothing and prints nothing",
|
|
7
7
|
"description": "",
|
|
8
8
|
"positionals": [],
|
|
9
9
|
"options": [
|
|
@@ -235,6 +235,21 @@
|
|
|
235
235
|
"type": null,
|
|
236
236
|
"hidden": false
|
|
237
237
|
},
|
|
238
|
+
{
|
|
239
|
+
"names": [
|
|
240
|
+
"--context-window"
|
|
241
|
+
],
|
|
242
|
+
"dest": "context_window",
|
|
243
|
+
"metavar": null,
|
|
244
|
+
"help": "the model context window the install is built for: 200k|1m (default: 200k). On Claude Code it sets the skill-listing budget in settings.json so every skill keeps a description; other hosts record it and write nothing",
|
|
245
|
+
"choices": null,
|
|
246
|
+
"default": null,
|
|
247
|
+
"required": false,
|
|
248
|
+
"nargs": null,
|
|
249
|
+
"is_flag": false,
|
|
250
|
+
"type": null,
|
|
251
|
+
"hidden": false
|
|
252
|
+
},
|
|
238
253
|
{
|
|
239
254
|
"names": [
|
|
240
255
|
"--out"
|
|
@@ -488,6 +503,21 @@
|
|
|
488
503
|
"is_flag": true,
|
|
489
504
|
"type": null,
|
|
490
505
|
"hidden": false
|
|
506
|
+
},
|
|
507
|
+
{
|
|
508
|
+
"names": [
|
|
509
|
+
"--scores"
|
|
510
|
+
],
|
|
511
|
+
"dest": "scores",
|
|
512
|
+
"metavar": null,
|
|
513
|
+
"help": "with the agents section: each agent's recorded runs per spec hash, from each active install's notebook/agent-runs.jsonl (read-only)",
|
|
514
|
+
"choices": null,
|
|
515
|
+
"default": false,
|
|
516
|
+
"required": false,
|
|
517
|
+
"nargs": "0",
|
|
518
|
+
"is_flag": true,
|
|
519
|
+
"type": null,
|
|
520
|
+
"hidden": false
|
|
491
521
|
}
|
|
492
522
|
],
|
|
493
523
|
"mutex": []
|
|
@@ -1579,6 +1609,120 @@
|
|
|
1579
1609
|
],
|
|
1580
1610
|
"mutex": []
|
|
1581
1611
|
},
|
|
1612
|
+
{
|
|
1613
|
+
"name": "profile",
|
|
1614
|
+
"help": "apply an install profile, or save an install as one",
|
|
1615
|
+
"description": "apply an install profile globally or to one project folder, or save an existing install as one. Profiles come from two sources: Shipped (profiles/ in this checkout) and Personal (profiles/ in the machine-wide Geneseed folder, beside memory and rules). apply builds the profile into each host it names that this machine has (--hosts narrows it) and touches no other install; it puts nothing on PATH and starts no console. save copies every build setting of one install as it is, gates switched off included, writes a Personal profile unless --shipped, and prints how it differs from starter. It reads no user rules, profile, memory, wiki or notebook",
|
|
1616
|
+
"positionals": [
|
|
1617
|
+
{
|
|
1618
|
+
"names": [],
|
|
1619
|
+
"dest": "action",
|
|
1620
|
+
"metavar": null,
|
|
1621
|
+
"help": "save — write NAME.json from the install named by --from; apply — build profile NAME into this machine's hosts",
|
|
1622
|
+
"choices": [
|
|
1623
|
+
"save",
|
|
1624
|
+
"apply"
|
|
1625
|
+
],
|
|
1626
|
+
"default": null,
|
|
1627
|
+
"required": true,
|
|
1628
|
+
"nargs": null,
|
|
1629
|
+
"is_flag": false,
|
|
1630
|
+
"type": null,
|
|
1631
|
+
"hidden": false
|
|
1632
|
+
},
|
|
1633
|
+
{
|
|
1634
|
+
"names": [],
|
|
1635
|
+
"dest": "name",
|
|
1636
|
+
"metavar": null,
|
|
1637
|
+
"help": "the profile name (a file stem: letters, digits, '.', '_' and '-')",
|
|
1638
|
+
"choices": null,
|
|
1639
|
+
"default": null,
|
|
1640
|
+
"required": true,
|
|
1641
|
+
"nargs": null,
|
|
1642
|
+
"is_flag": false,
|
|
1643
|
+
"type": null,
|
|
1644
|
+
"hidden": false
|
|
1645
|
+
}
|
|
1646
|
+
],
|
|
1647
|
+
"options": [
|
|
1648
|
+
{
|
|
1649
|
+
"names": [
|
|
1650
|
+
"--from"
|
|
1651
|
+
],
|
|
1652
|
+
"dest": "from",
|
|
1653
|
+
"metavar": "EMIT",
|
|
1654
|
+
"help": "save: the install to read — opencode-global, claude-global, bob-global or openclaude-global, or a bare host (opencode, claude, bob, openclaude) with --project for a project install",
|
|
1655
|
+
"choices": null,
|
|
1656
|
+
"default": null,
|
|
1657
|
+
"required": false,
|
|
1658
|
+
"nargs": null,
|
|
1659
|
+
"is_flag": false,
|
|
1660
|
+
"type": null,
|
|
1661
|
+
"hidden": false
|
|
1662
|
+
},
|
|
1663
|
+
{
|
|
1664
|
+
"names": [
|
|
1665
|
+
"--project"
|
|
1666
|
+
],
|
|
1667
|
+
"dest": "project",
|
|
1668
|
+
"metavar": "DIR",
|
|
1669
|
+
"help": "apply: build into this project folder instead of globally; save: the folder of the project install --from names",
|
|
1670
|
+
"choices": null,
|
|
1671
|
+
"default": null,
|
|
1672
|
+
"required": false,
|
|
1673
|
+
"nargs": null,
|
|
1674
|
+
"is_flag": false,
|
|
1675
|
+
"type": null,
|
|
1676
|
+
"hidden": false
|
|
1677
|
+
},
|
|
1678
|
+
{
|
|
1679
|
+
"names": [
|
|
1680
|
+
"--hosts"
|
|
1681
|
+
],
|
|
1682
|
+
"dest": "hosts",
|
|
1683
|
+
"metavar": "HOSTS",
|
|
1684
|
+
"help": "apply: comma-separated hosts to build, a subset of the profile's (default: each of them this machine has)",
|
|
1685
|
+
"choices": null,
|
|
1686
|
+
"default": null,
|
|
1687
|
+
"required": false,
|
|
1688
|
+
"nargs": null,
|
|
1689
|
+
"is_flag": false,
|
|
1690
|
+
"type": null,
|
|
1691
|
+
"hidden": false
|
|
1692
|
+
},
|
|
1693
|
+
{
|
|
1694
|
+
"names": [
|
|
1695
|
+
"--shipped"
|
|
1696
|
+
],
|
|
1697
|
+
"dest": "shipped",
|
|
1698
|
+
"metavar": null,
|
|
1699
|
+
"help": "save: write profiles/NAME.json in this checkout (a git clone only) instead of a Personal profile",
|
|
1700
|
+
"choices": null,
|
|
1701
|
+
"default": false,
|
|
1702
|
+
"required": false,
|
|
1703
|
+
"nargs": "0",
|
|
1704
|
+
"is_flag": true,
|
|
1705
|
+
"type": null,
|
|
1706
|
+
"hidden": false
|
|
1707
|
+
},
|
|
1708
|
+
{
|
|
1709
|
+
"names": [
|
|
1710
|
+
"--force"
|
|
1711
|
+
],
|
|
1712
|
+
"dest": "force",
|
|
1713
|
+
"metavar": null,
|
|
1714
|
+
"help": "save: replace NAME.json when it already exists in the same source (that file only)",
|
|
1715
|
+
"choices": null,
|
|
1716
|
+
"default": false,
|
|
1717
|
+
"required": false,
|
|
1718
|
+
"nargs": "0",
|
|
1719
|
+
"is_flag": true,
|
|
1720
|
+
"type": null,
|
|
1721
|
+
"hidden": false
|
|
1722
|
+
}
|
|
1723
|
+
],
|
|
1724
|
+
"mutex": []
|
|
1725
|
+
},
|
|
1582
1726
|
{
|
|
1583
1727
|
"name": "prompt",
|
|
1584
1728
|
"help": "emit a self-contained install prompt",
|
|
@@ -1780,10 +1924,26 @@
|
|
|
1780
1924
|
},
|
|
1781
1925
|
{
|
|
1782
1926
|
"name": "setup",
|
|
1783
|
-
"help": "
|
|
1784
|
-
"description": "",
|
|
1927
|
+
"help": "install wizard; --profile NAME installs a profile with no questions",
|
|
1928
|
+
"description": "interactive install wizard (dependency-free, all OSes). With --profile <name>, it asks nothing: it installs that profile (Shipped, from profiles/ in this checkout, or Personal, from profiles/ in the machine-wide Geneseed folder) globally into each AI coding tool the profile lists that is found on this machine, puts geneseed on PATH, sets the web console to start at login, starts it, and runs the doctor",
|
|
1785
1929
|
"positionals": [],
|
|
1786
|
-
"options": [
|
|
1930
|
+
"options": [
|
|
1931
|
+
{
|
|
1932
|
+
"names": [
|
|
1933
|
+
"--profile"
|
|
1934
|
+
],
|
|
1935
|
+
"dest": "profile",
|
|
1936
|
+
"metavar": "NAME",
|
|
1937
|
+
"help": "install profile NAME (Shipped, in profiles/, or Personal, in the machine-wide profiles/) globally with no questions (e.g. starter); works without a terminal",
|
|
1938
|
+
"choices": null,
|
|
1939
|
+
"default": null,
|
|
1940
|
+
"required": false,
|
|
1941
|
+
"nargs": null,
|
|
1942
|
+
"is_flag": false,
|
|
1943
|
+
"type": null,
|
|
1944
|
+
"hidden": false
|
|
1945
|
+
}
|
|
1946
|
+
],
|
|
1787
1947
|
"mutex": []
|
|
1788
1948
|
},
|
|
1789
1949
|
{
|