@a5c-ai/babysitter-github 5.0.1-staging.e4f17eff → 5.0.1-staging.fcac7259

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 (38) hide show
  1. package/bin/cli.js +14 -26
  2. package/bin/install-shared.js +382 -210
  3. package/bin/install.js +41 -90
  4. package/bin/uninstall.js +12 -63
  5. package/commands/doctor.md +5 -5
  6. package/commands/help.md +245 -244
  7. package/commands/observe.md +12 -12
  8. package/hooks/babysitter-proxied-session-end.ps1 +10 -114
  9. package/hooks/babysitter-proxied-session-end.sh +2 -111
  10. package/hooks/babysitter-proxied-session-start.ps1 +10 -187
  11. package/hooks/babysitter-proxied-session-start.sh +6 -168
  12. package/hooks/babysitter-proxied-user-prompt-submitted.ps1 +10 -90
  13. package/hooks/babysitter-proxied-user-prompt-submitted.sh +2 -86
  14. package/hooks.json +10 -10
  15. package/package.json +18 -20
  16. package/plugin.json +7 -6
  17. package/scripts/team-install.js +14 -84
  18. package/skills/cleanup/SKILL.md +21 -0
  19. package/skills/contrib/SKILL.md +34 -0
  20. package/skills/doctor/SKILL.md +5 -5
  21. package/skills/forever/SKILL.md +8 -0
  22. package/skills/help/SKILL.md +3 -2
  23. package/skills/observe/SKILL.md +1 -1
  24. package/skills/plugins/SKILL.md +257 -0
  25. package/skills/project-install/SKILL.md +18 -0
  26. package/skills/resume/SKILL.md +1 -1
  27. package/skills/retrospect/SKILL.md +48 -48
  28. package/skills/user-install/SKILL.md +3 -3
  29. package/skills/yolo/SKILL.md +8 -0
  30. package/versions.json +1 -1
  31. package/.github/plugin.json +0 -25
  32. package/hooks/proxied-hooks.json +0 -29
  33. package/hooks/session-end.ps1 +0 -69
  34. package/hooks/session-end.sh +0 -54
  35. package/hooks/session-start.ps1 +0 -111
  36. package/hooks/session-start.sh +0 -101
  37. package/hooks/user-prompt-submitted.ps1 +0 -52
  38. package/hooks/user-prompt-submitted.sh +0 -31
package/bin/install.js CHANGED
@@ -2,126 +2,77 @@
2
2
  'use strict';
3
3
 
4
4
  const path = require('path');
5
- const { spawnSync } = require('child_process');
6
- const {
7
- copyPluginBundle,
8
- ensureGlobalProcessLibrary,
9
- ensureMarketplaceEntry,
10
- getCopilotHome,
11
- getHomeMarketplacePath,
12
- getHomePluginRoot,
13
- installCloudAgentSurface,
14
- installCopilotSurface,
15
- warnWindowsHooks,
16
- } = require('./install-shared');
5
+ const shared = require('./install-shared');
17
6
 
18
7
  const PACKAGE_ROOT = path.resolve(__dirname, '..');
19
8
 
20
9
  function parseArgs(argv) {
21
- const args = {
22
- cloudAgent: false,
23
- workspace: process.cwd(),
24
- };
10
+ let workspace = null;
11
+ let cloudAgent = false;
25
12
 
26
13
  for (let i = 0; i < argv.length; i += 1) {
27
14
  const arg = argv[i];
28
15
  if (arg === '--cloud-agent') {
29
- args.cloudAgent = true;
16
+ cloudAgent = true;
30
17
  continue;
31
18
  }
32
19
  if (arg === '--workspace') {
33
20
  const next = argv[i + 1];
34
21
  if (next && !next.startsWith('-')) {
35
- args.workspace = path.resolve(next);
22
+ workspace = path.resolve(next);
36
23
  i += 1;
37
24
  } else {
38
- args.workspace = process.cwd();
25
+ workspace = process.cwd();
39
26
  }
40
27
  }
41
28
  }
42
29
 
43
- return args;
44
- }
45
-
46
- /**
47
- * Attempt to register the plugin via `copilot plugin install ./path`.
48
- * Falls back to manual config.json registration if the CLI is not available.
49
- */
50
- function registerViaCopilotCli(pluginRoot) {
51
- const result = spawnSync('copilot', ['plugin', 'install', pluginRoot], {
52
- stdio: ['ignore', 'pipe', 'pipe'],
53
- encoding: 'utf8',
54
- timeout: 30000,
55
- });
56
-
57
- if (result.status === 0) {
58
- console.log(`[babysitter] Registered plugin via 'copilot plugin install'`);
59
- return true;
60
- }
61
-
62
- // CLI not available or failed -- fall back to manual registration
63
- const stderr = (result.stderr || '').trim();
64
- if (result.error || stderr.includes('not found') || stderr.includes('not recognized')) {
65
- console.log(`[babysitter] Copilot CLI not found, using manual registration`);
66
- } else {
67
- console.warn(`[babysitter] 'copilot plugin install' failed: ${stderr || 'unknown error'}, using manual registration`);
68
- }
69
- return false;
30
+ return { cloudAgent, workspace };
70
31
  }
71
32
 
72
33
  function main() {
73
- const args = parseArgs(process.argv.slice(2));
74
- const copilotHome = getCopilotHome();
75
- const pluginRoot = getHomePluginRoot();
76
- const marketplacePath = getHomeMarketplacePath();
34
+ const options = parseArgs(process.argv.slice(2));
77
35
 
78
- if (args.cloudAgent) {
79
- const active = ensureGlobalProcessLibrary(PACKAGE_ROOT);
80
- const installed = installCloudAgentSurface(PACKAGE_ROOT, args.workspace);
81
- console.log(`[babysitter] Installed Copilot cloud-agent support into ${args.workspace}`);
82
- console.log(`[babysitter] plugin bundle: ${installed.bundleRoot}`);
83
- console.log(`[babysitter] skills: ${path.join(args.workspace, '.github', 'skills')}`);
84
- console.log(`[babysitter] instructions: ${installed.copilotInstructionsPath}`);
85
- console.log(`[babysitter] agents: ${installed.agentsPath}`);
86
- if (installed.setupWorkflow.needsManualMerge) {
87
- console.warn(`[babysitter] Existing copilot-setup-steps workflow preserved: ${installed.setupWorkflow.workflowPath}`);
88
- console.warn(`[babysitter] Merge Babysitter setup steps from: ${installed.setupWorkflow.examplePath}`);
89
- } else {
90
- console.log(`[babysitter] setup workflow: ${installed.setupWorkflow.workflowPath}`);
36
+ if (options.cloudAgent) {
37
+ if (!options.workspace) {
38
+ console.error(`[${shared.PLUGIN_NAME}] Failed to install: --cloud-agent requires --workspace <path>.`);
39
+ process.exitCode = 1;
40
+ return;
91
41
  }
92
- console.log(`[babysitter] process library: ${active.binding?.dir}`);
93
- console.log(`[babysitter] process library state: ${active.stateFile}`);
94
- console.log('[babysitter] Cloud-agent installation complete!');
95
- return;
96
- }
97
42
 
98
- console.log(`[babysitter] Installing plugin to ${pluginRoot}`);
99
-
100
- try {
101
- copyPluginBundle(PACKAGE_ROOT, pluginRoot);
102
- ensureMarketplaceEntry(marketplacePath, pluginRoot);
103
-
104
- // Try native copilot CLI registration first; fall back to manual config.json
105
- if (!registerViaCopilotCli(pluginRoot)) {
106
- const { registerCopilotPlugin } = require('./install-shared');
107
- registerCopilotPlugin(pluginRoot);
43
+ try {
44
+ const installResult = shared.installCloudAgentSurface(PACKAGE_ROOT, options.workspace);
45
+ shared.ensureGlobalProcessLibrary(PACKAGE_ROOT);
46
+ console.log(`[${shared.PLUGIN_NAME}] Installed cloud-agent support into ${options.workspace}`);
47
+ if (installResult.setupWorkflow && installResult.setupWorkflow.examplePath) {
48
+ console.log(
49
+ `[${shared.PLUGIN_NAME}] Existing copilot setup workflow preserved; merge candidate written to ${installResult.setupWorkflow.examplePath}`,
50
+ );
51
+ }
52
+ return;
53
+ } catch (err) {
54
+ console.error(`[${shared.PLUGIN_NAME}] Failed to install cloud-agent support: ${err.message}`);
55
+ process.exitCode = 1;
56
+ return;
108
57
  }
58
+ }
59
+
60
+ const pluginRoot = shared.getHomePluginRoot();
61
+ const marketplacePath = shared.getHomeMarketplacePath();
109
62
 
110
- installCopilotSurface(PACKAGE_ROOT, copilotHome);
63
+ console.log(`[${shared.PLUGIN_NAME}] Installing plugin to ${pluginRoot}`);
111
64
 
112
- const active = ensureGlobalProcessLibrary(PACKAGE_ROOT);
113
- console.log(`[babysitter] marketplace: ${marketplacePath}`);
114
- console.log(`[babysitter] copilot config: ${path.join(copilotHome, 'config.json')}`);
115
- console.log(`[babysitter] process library: ${active.binding?.dir}`);
116
- if (active.defaultSpec?.cloneDir) {
117
- console.log(`[babysitter] process library clone: ${active.defaultSpec.cloneDir}`);
65
+ try {
66
+ shared.copyPluginBundle(PACKAGE_ROOT, pluginRoot);
67
+ shared.ensureMarketplaceEntry(marketplacePath, pluginRoot);
68
+ if (typeof shared.harnessInstall === 'function') {
69
+ shared.harnessInstall(PACKAGE_ROOT, pluginRoot);
118
70
  }
119
- console.log(`[babysitter] process library state: ${active.stateFile}`);
120
- warnWindowsHooks();
121
- console.log('[babysitter] Installation complete!');
122
- console.log('[babysitter] Restart GitHub Copilot CLI to pick up the installed plugin and config changes.');
71
+ shared.runPostInstall && shared.runPostInstall(pluginRoot);
72
+ console.log(`[${shared.PLUGIN_NAME}] Installation complete!`);
73
+ console.log(`[${shared.PLUGIN_NAME}] Restart your IDE/CLI to pick up the plugin.`);
123
74
  } catch (err) {
124
- console.error(`[babysitter] Failed to install plugin: ${err.message}`);
75
+ console.error(`[${shared.PLUGIN_NAME}] Failed to install: ${err.message}`);
125
76
  process.exitCode = 1;
126
77
  }
127
78
  }
package/bin/uninstall.js CHANGED
@@ -1,76 +1,25 @@
1
1
  #!/usr/bin/env node
2
2
  'use strict';
3
3
 
4
+ const path = require('path');
4
5
  const fs = require('fs');
5
- const { spawnSync } = require('child_process');
6
- const {
7
- deregisterCopilotPlugin,
8
- getCopilotHome,
9
- getHomeMarketplacePath,
10
- getHomePluginRoot,
11
- removeLegacyHooks,
12
- removeMarketplaceEntry,
13
- } = require('./install-shared');
14
-
15
- const PLUGIN_NAME = 'babysitter';
16
-
17
- /**
18
- * Attempt to unregister the plugin via `copilot plugin uninstall`.
19
- * Falls back to manual config.json cleanup if the CLI is not available.
20
- */
21
- function unregisterViaCopilotCli() {
22
- const result = spawnSync('copilot', ['plugin', 'uninstall', PLUGIN_NAME], {
23
- stdio: ['ignore', 'pipe', 'pipe'],
24
- encoding: 'utf8',
25
- timeout: 30000,
26
- });
27
-
28
- if (result.status === 0) {
29
- console.log(`[${PLUGIN_NAME}] Unregistered plugin via 'copilot plugin uninstall'`);
30
- return true;
31
- }
32
-
33
- // CLI not available or failed
34
- const stderr = (result.stderr || '').trim();
35
- if (result.error || stderr.includes('not found') || stderr.includes('not recognized')) {
36
- console.log(`[${PLUGIN_NAME}] Copilot CLI not found, using manual cleanup`);
37
- } else {
38
- console.warn(`[${PLUGIN_NAME}] 'copilot plugin uninstall' failed: ${stderr || 'unknown error'}, using manual cleanup`);
39
- }
40
- return false;
41
- }
6
+ const shared = require('./install-shared');
42
7
 
43
8
  function main() {
44
- const copilotHome = getCopilotHome();
45
- const pluginRoot = getHomePluginRoot();
46
- const marketplacePath = getHomeMarketplacePath();
47
- let removedPlugin = false;
9
+ const pluginRoot = shared.getHomePluginRoot();
48
10
 
49
- if (fs.existsSync(pluginRoot)) {
50
- try {
51
- fs.rmSync(pluginRoot, { recursive: true, force: true });
52
- console.log(`[${PLUGIN_NAME}] Removed ${pluginRoot}`);
53
- removedPlugin = true;
54
- } catch (err) {
55
- console.warn(`[${PLUGIN_NAME}] Warning: Could not remove plugin directory ${pluginRoot}: ${err.message}`);
56
- }
57
- }
58
-
59
- removeMarketplaceEntry(marketplacePath);
60
-
61
- // Try native copilot CLI unregistration first; fall back to manual config.json
62
- if (!unregisterViaCopilotCli()) {
63
- deregisterCopilotPlugin(pluginRoot);
64
- }
65
-
66
- removeLegacyHooks(copilotHome);
67
-
68
- if (!removedPlugin) {
69
- console.log(`[${PLUGIN_NAME}] Plugin directory not found, config and hooks cleaned if present.`);
11
+ if (!fs.existsSync(pluginRoot)) {
12
+ console.log(`[${shared.PLUGIN_NAME}] Plugin not installed at ${pluginRoot}`);
70
13
  return;
71
14
  }
72
15
 
73
- console.log(`[${PLUGIN_NAME}] Restart GitHub Copilot CLI to complete uninstallation.`);
16
+ try {
17
+ fs.rmSync(pluginRoot, { recursive: true, force: true });
18
+ console.log(`[${shared.PLUGIN_NAME}] Uninstalled from ${pluginRoot}`);
19
+ } catch (err) {
20
+ console.error(`[${shared.PLUGIN_NAME}] Failed to uninstall: ${err.message}`);
21
+ process.exitCode = 1;
22
+ }
74
23
  }
75
24
 
76
25
  main();
@@ -362,13 +362,13 @@ Mark as FAIL if:
362
362
  - Parse the output and inspect the `resolvedFrom` field. Classify as follows:
363
363
  - `resolvedFrom: "pid-marker"` → mark as PASS ("Session ID derives from the live Claude Code ancestor process -- authoritative").
364
364
  - `resolvedFrom: "env-file"` → mark as PASS with a note ("CLAUDE_ENV_FILE was used; typically healthy").
365
- - `resolvedFrom: "env-var"` → mark as WARN ("`BABYSITTER_SESSION_ID` is set without a corroborating PID marker. Likely stale from a prior Claude Code session -- see GitHub issue #130").
366
- - Remediation: run `babysitter session:cleanup` and start a fresh Claude Code session, or `unset BABYSITTER_SESSION_ID` before invoking babysitter.
365
+ - `resolvedFrom: "env-var"` → mark as WARN ("`AGENT_SESSION_ID` is set without a corroborating PID marker. Likely stale from a prior Claude Code session -- see GitHub issue #130").
366
+ - Remediation: run `babysitter session:cleanup` and start a fresh Claude Code session, or `unset AGENT_SESSION_ID` before invoking babysitter.
367
367
  - `resolvedFrom: "none"` → mark as ERROR ("No session ID resolvable. Either no session-start hook fired, or the ancestor walk failed").
368
368
 
369
369
  **Env-var shadow check:**
370
370
  - Independently inspect `envVarPresent` and `envVarMatches` in the output.
371
- - If `envVarPresent && !envVarMatches`, mark as WARN ("`BABYSITTER_SESSION_ID` in env does not match the resolved session ID; a stale value is shadowing the authoritative one. Unset the env var").
371
+ - If `envVarPresent && !envVarMatches`, mark as WARN ("`AGENT_SESSION_ID` in env does not match the resolved session ID; a stale value is shadowing the authoritative one. Unset the env var").
372
372
 
373
373
  ---
374
374
 
@@ -390,7 +390,7 @@ Mark as FAIL if:
390
390
 
391
391
  - Enumerate files in `~/.a5c/` matching the pattern `current-session-*-pid-*`.
392
392
  - Count markers per harness (derived from the filename).
393
- - If more than one live marker exists for the same harness, mark as INFO ("Multiple live Claude Code / harness sessions detected; ensure each shell scopes `BABYSITTER_SESSION_ID` appropriately -- the PID marker handles this automatically").
393
+ - If more than one live marker exists for the same harness, mark as INFO ("Multiple live Claude Code / harness sessions detected; ensure each shell scopes `AGENT_SESSION_ID` appropriately -- the PID marker handles this automatically").
394
394
  - Otherwise mark as PASS.
395
395
 
396
396
  ---
@@ -501,7 +501,7 @@ babysitter session:cleanup --dry-run # preview
501
501
  babysitter session:cleanup # apply
502
502
 
503
503
  # 2. Unset a stale env var
504
- unset BABYSITTER_SESSION_ID
504
+ unset AGENT_SESSION_ID
505
505
 
506
506
  # 3. Re-bind a run explicitly if needed
507
507
  babysitter session:resume --session-id <fresh-id> --state-dir ~/.a5c --run-id <runId> --runs-dir .a5c/runs