@thomas-powers-jr/cadence-host-claude-code 1.54.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/LICENSE +21 -0
- package/README.md +5 -0
- package/bin/cadence-host-claude-code.cjs +4 -0
- package/dist/capabilities.d.ts +3 -0
- package/dist/capabilities.d.ts.map +1 -0
- package/dist/capabilities.js +17 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +124 -0
- package/dist/cli.js.map +1 -0
- package/dist/event-map.d.ts +4 -0
- package/dist/event-map.d.ts.map +1 -0
- package/dist/event-map.js +7 -0
- package/dist/event-map.js.map +1 -0
- package/dist/index.d.ts +36 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/install-commands.d.ts +20 -0
- package/dist/install-commands.d.ts.map +1 -0
- package/dist/install-commands.js +53 -0
- package/dist/install-commands.js.map +1 -0
- package/dist/install.d.ts +23 -0
- package/dist/install.d.ts.map +1 -0
- package/dist/install.js +85 -0
- package/dist/install.js.map +1 -0
- package/dist/locate-self.d.ts +14 -0
- package/dist/locate-self.d.ts.map +1 -0
- package/dist/locate-self.js +15 -0
- package/dist/locate-self.js.map +1 -0
- package/dist/shim.d.ts +3 -0
- package/dist/shim.d.ts.map +1 -0
- package/dist/shim.js +2 -0
- package/dist/shim.js.map +1 -0
- package/package.json +63 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Thomas Powers
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE,eAAO,MAAM,sBAAsB,EAAE,gBAepC,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export const claudeCodeCapabilities = {
|
|
2
|
+
hooks: [
|
|
3
|
+
'session-start',
|
|
4
|
+
'user-prompt',
|
|
5
|
+
'pre-tool-edit',
|
|
6
|
+
'post-tool-edit',
|
|
7
|
+
'session-stop',
|
|
8
|
+
'subagent-result',
|
|
9
|
+
'subagent-start',
|
|
10
|
+
],
|
|
11
|
+
slashCommands: true,
|
|
12
|
+
skillSystem: 'native',
|
|
13
|
+
blockingHooks: ['pre-tool-edit', 'session-stop', 'subagent-result'],
|
|
14
|
+
subagentSpawn: 'native',
|
|
15
|
+
streamingOutput: true,
|
|
16
|
+
};
|
|
17
|
+
//# sourceMappingURL=capabilities.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD,KAAK,EAAE;QACL,eAAe;QACf,aAAa;QACb,eAAe;QACf,gBAAgB;QAChB,cAAc;QACd,iBAAiB;QACjB,gBAAgB;KACjB;IACD,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,iBAAiB,CAAC;IACnE,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,IAAI;CACtB,CAAC"}
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
|
package/dist/cli.js
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { Command } from 'commander';
|
|
2
|
+
import { spawn } from 'node:child_process';
|
|
3
|
+
import { readFileSync } from 'node:fs';
|
|
4
|
+
import { fileURLToPath } from 'node:url';
|
|
5
|
+
import { dirname, join } from 'node:path';
|
|
6
|
+
import { installHooks } from './install.js';
|
|
7
|
+
import { installCommands } from './install-commands.js';
|
|
8
|
+
import { routeHookEvent } from './shim.js';
|
|
9
|
+
// Read the real version from package.json so `--version` never drifts.
|
|
10
|
+
// Resolves dist/cli.js → ../package.json.
|
|
11
|
+
const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '../package.json'), 'utf8'));
|
|
12
|
+
const program = new Command();
|
|
13
|
+
program
|
|
14
|
+
.name('cadence-host-claude-code')
|
|
15
|
+
.description('Claude Code host adapter for CADENCE')
|
|
16
|
+
.version(pkg.version);
|
|
17
|
+
program
|
|
18
|
+
.command('install')
|
|
19
|
+
.description('Write Claude Code hook entries and slash commands into the project')
|
|
20
|
+
.option('--cwd <dir>', 'project root', process.cwd())
|
|
21
|
+
.option('--command <cmd>', 'base command for the shim (default: "npx @thomas-powers-jr/cadence-host-claude-code")')
|
|
22
|
+
.option('--cadence <cmd>', 'base command the shim uses to invoke core (default: "npx @thomas-powers-jr/cadence-core")')
|
|
23
|
+
.option('--settings <path>', 'settings file path relative to cwd', '.claude/settings.json')
|
|
24
|
+
.option('--no-hooks', 'skip writing hooks to settings.json')
|
|
25
|
+
.option('--no-commands', 'skip writing slash commands to .claude/commands/')
|
|
26
|
+
.option('--local', 'use absolute paths to the local workspace builds (monorepo dogfood)')
|
|
27
|
+
.action(async (opts) => {
|
|
28
|
+
try {
|
|
29
|
+
if (opts.hooks) {
|
|
30
|
+
const installOpts = { settingsPath: opts.settings };
|
|
31
|
+
if (opts.command !== undefined)
|
|
32
|
+
installOpts.command = opts.command;
|
|
33
|
+
if (opts.cadence !== undefined)
|
|
34
|
+
installOpts.cadenceCommand = opts.cadence;
|
|
35
|
+
if (opts.local)
|
|
36
|
+
installOpts.local = true;
|
|
37
|
+
await installHooks(opts.cwd, installOpts);
|
|
38
|
+
process.stdout.write(`Installed CADENCE hooks → ${opts.cwd}/${opts.settings}\n`);
|
|
39
|
+
}
|
|
40
|
+
if (opts.commands) {
|
|
41
|
+
const cmdOpts = {};
|
|
42
|
+
if (opts.cadence !== undefined)
|
|
43
|
+
cmdOpts.cadenceCommand = opts.cadence;
|
|
44
|
+
if (opts.local)
|
|
45
|
+
cmdOpts.local = true;
|
|
46
|
+
await installCommands(opts.cwd, cmdOpts);
|
|
47
|
+
process.stdout.write(`Installed CADENCE slash commands → ${opts.cwd}/.claude/commands/\n`);
|
|
48
|
+
}
|
|
49
|
+
process.stdout.write('Start a new Claude Code session to activate.\n');
|
|
50
|
+
if (opts.local) {
|
|
51
|
+
// --local bakes machine-absolute paths into EVERY surface it writes —
|
|
52
|
+
// both the hooks (settings.json) and the slash commands
|
|
53
|
+
// (.claude/commands/cadence-*.md). Name each surface that was actually
|
|
54
|
+
// written so none gets committed by accident. The command files were
|
|
55
|
+
// the silent offender before this enumeration existed: the warning
|
|
56
|
+
// named only settings.json, so machine-absolute command files were
|
|
57
|
+
// committed unflagged and broke on every other clone/machine.
|
|
58
|
+
const surfaces = [];
|
|
59
|
+
if (opts.hooks)
|
|
60
|
+
surfaces.push(opts.settings);
|
|
61
|
+
if (opts.commands)
|
|
62
|
+
surfaces.push('.claude/commands/cadence-*.md');
|
|
63
|
+
if (surfaces.length > 0) {
|
|
64
|
+
process.stderr.write(`warning: --local wrote machine-absolute paths into ${surfaces.join(' and ')}. ` +
|
|
65
|
+
'Do NOT commit them — they cannot be resolved on other clones or ' +
|
|
66
|
+
'machines. Add them to .gitignore and re-run `install --local` per ' +
|
|
67
|
+
'machine, or run plain `install` (no --local) to write the portable ' +
|
|
68
|
+
'`cadence` form that is safe to commit.\n');
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
catch (err) {
|
|
73
|
+
process.stderr.write(`install failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
74
|
+
process.exitCode = 1;
|
|
75
|
+
}
|
|
76
|
+
});
|
|
77
|
+
program
|
|
78
|
+
.command('hook')
|
|
79
|
+
.description('Shim invoked by Claude Code hooks: translates stdin and calls cadence hook <event>')
|
|
80
|
+
.option('--cadence <cmd>', 'base command to invoke core (default: "npx @thomas-powers-jr/cadence-core")', 'npx @thomas-powers-jr/cadence-core')
|
|
81
|
+
.action(async (opts) => {
|
|
82
|
+
try {
|
|
83
|
+
let raw = '';
|
|
84
|
+
if (!process.stdin.isTTY) {
|
|
85
|
+
for await (const chunk of process.stdin)
|
|
86
|
+
raw += chunk.toString();
|
|
87
|
+
}
|
|
88
|
+
const { abstractEvent, translatedStdin } = routeHookEvent(raw);
|
|
89
|
+
if (abstractEvent === null)
|
|
90
|
+
return; // exit 0 silently for unmapped events
|
|
91
|
+
const [exe, ...baseArgs] = opts.cadence.split(/\s+/).filter(Boolean);
|
|
92
|
+
if (!exe) {
|
|
93
|
+
process.stderr.write('--cadence command is empty\n');
|
|
94
|
+
process.exitCode = 1;
|
|
95
|
+
return;
|
|
96
|
+
}
|
|
97
|
+
const child = spawn(exe, [...baseArgs, 'hook', abstractEvent], {
|
|
98
|
+
stdio: ['pipe', 'inherit', 'inherit'],
|
|
99
|
+
shell: process.platform === 'win32',
|
|
100
|
+
});
|
|
101
|
+
child.stdin.write(translatedStdin);
|
|
102
|
+
child.stdin.end();
|
|
103
|
+
await new Promise((resolve) => {
|
|
104
|
+
child.on('exit', (code) => {
|
|
105
|
+
process.exitCode = code ?? 0;
|
|
106
|
+
resolve();
|
|
107
|
+
});
|
|
108
|
+
child.on('error', (err) => {
|
|
109
|
+
process.stderr.write(`shim spawn failed: ${err.message}\n`);
|
|
110
|
+
process.exitCode = 1;
|
|
111
|
+
resolve();
|
|
112
|
+
});
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
catch (err) {
|
|
116
|
+
process.stderr.write(`hook shim failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
117
|
+
process.exitCode = 1;
|
|
118
|
+
}
|
|
119
|
+
});
|
|
120
|
+
program.parseAsync(process.argv).catch((err) => {
|
|
121
|
+
process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
|
|
122
|
+
process.exit(1);
|
|
123
|
+
});
|
|
124
|
+
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ExtractedPayload } from '@thomas-powers-jr/cadence-types';
|
|
2
|
+
export { mapEvent, extractPayload, EDIT_TOOL_MATCHER, SKILL_TOOL_MATCHER, } from '@thomas-powers-jr/cadence-host-toolkit';
|
|
3
|
+
export type { ExtractedPayload };
|
|
4
|
+
//# sourceMappingURL=event-map.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"event-map.d.ts","sourceRoot":"","sources":["../src/event-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAOxE,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAIhD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// The dispatch algorithm (mapEvent/extractPayload) and the edit/skill tool
|
|
2
|
+
// matchers now live in the shared toolkit package, `@thomas-powers-jr/cadence-host-toolkit`
|
|
3
|
+
// (phase 222) — this module re-exports it so existing imports of
|
|
4
|
+
// `./event-map.js` throughout host-claude-code (and its tests) keep working
|
|
5
|
+
// unchanged.
|
|
6
|
+
export { mapEvent, extractPayload, EDIT_TOOL_MATCHER, SKILL_TOOL_MATCHER, } from '@thomas-powers-jr/cadence-host-toolkit';
|
|
7
|
+
//# sourceMappingURL=event-map.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"event-map.js","sourceRoot":"","sources":["../src/event-map.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,4FAA4F;AAC5F,iEAAiE;AACjE,4EAA4E;AAC5E,aAAa;AACb,OAAO,EACL,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wCAAwC,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { mapEvent, extractPayload } from './event-map.js';
|
|
2
|
+
import { installHooks } from './install.js';
|
|
3
|
+
import { installCommands } from './install-commands.js';
|
|
4
|
+
export { mapEvent, extractPayload, EDIT_TOOL_MATCHER } from './event-map.js';
|
|
5
|
+
export type { ExtractedPayload } from './event-map.js';
|
|
6
|
+
export { claudeCodeCapabilities } from './capabilities.js';
|
|
7
|
+
export type { HostCapabilities } from '@thomas-powers-jr/cadence-types';
|
|
8
|
+
export { ADAPTER_CONTRACT_VERSION } from '@thomas-powers-jr/cadence-types';
|
|
9
|
+
export type { HostAdapter } from '@thomas-powers-jr/cadence-types';
|
|
10
|
+
export { installHooks } from './install.js';
|
|
11
|
+
export type { InstallOptions } from './install.js';
|
|
12
|
+
export { installCommands } from './install-commands.js';
|
|
13
|
+
export type { InstallCommandsOptions } from './install-commands.js';
|
|
14
|
+
/**
|
|
15
|
+
* The Claude Code host adapter — the reference implementation of the
|
|
16
|
+
* {@link HostAdapter} contract. Assembled from the existing translation,
|
|
17
|
+
* capability, and install pieces; the `satisfies` check is the compile-time
|
|
18
|
+
* conformance proof (AC-4).
|
|
19
|
+
*/
|
|
20
|
+
export declare const claudeCodeAdapter: {
|
|
21
|
+
contractVersion: number;
|
|
22
|
+
capabilities: {
|
|
23
|
+
hooks: ("session-start" | "user-prompt" | "pre-tool-edit" | "post-tool-edit" | "session-stop" | "subagent-result" | "subagent-start" | "skill-invoke")[];
|
|
24
|
+
slashCommands: boolean;
|
|
25
|
+
skillSystem: "none" | "native" | "prompted";
|
|
26
|
+
blockingHooks: ("session-start" | "user-prompt" | "pre-tool-edit" | "post-tool-edit" | "session-stop" | "subagent-result" | "subagent-start" | "skill-invoke")[];
|
|
27
|
+
subagentSpawn: "none" | "native" | "shell-out";
|
|
28
|
+
streamingOutput: boolean;
|
|
29
|
+
agentIdentification?: boolean | undefined;
|
|
30
|
+
};
|
|
31
|
+
mapEvent: typeof mapEvent;
|
|
32
|
+
extractPayload: typeof extractPayload;
|
|
33
|
+
installHooks: typeof installHooks;
|
|
34
|
+
installCommands: typeof installCommands;
|
|
35
|
+
};
|
|
36
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAuB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;CAOiC,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { ADAPTER_CONTRACT_VERSION } from '@thomas-powers-jr/cadence-types';
|
|
2
|
+
import { mapEvent, extractPayload } from './event-map.js';
|
|
3
|
+
import { claudeCodeCapabilities } from './capabilities.js';
|
|
4
|
+
import { installHooks } from './install.js';
|
|
5
|
+
import { installCommands } from './install-commands.js';
|
|
6
|
+
export { mapEvent, extractPayload, EDIT_TOOL_MATCHER } from './event-map.js';
|
|
7
|
+
export { claudeCodeCapabilities } from './capabilities.js';
|
|
8
|
+
export { ADAPTER_CONTRACT_VERSION } from '@thomas-powers-jr/cadence-types';
|
|
9
|
+
export { installHooks } from './install.js';
|
|
10
|
+
export { installCommands } from './install-commands.js';
|
|
11
|
+
/**
|
|
12
|
+
* The Claude Code host adapter — the reference implementation of the
|
|
13
|
+
* {@link HostAdapter} contract. Assembled from the existing translation,
|
|
14
|
+
* capability, and install pieces; the `satisfies` check is the compile-time
|
|
15
|
+
* conformance proof (AC-4).
|
|
16
|
+
*/
|
|
17
|
+
export const claudeCodeAdapter = {
|
|
18
|
+
contractVersion: ADAPTER_CONTRACT_VERSION,
|
|
19
|
+
capabilities: claudeCodeCapabilities,
|
|
20
|
+
mapEvent,
|
|
21
|
+
extractPayload,
|
|
22
|
+
installHooks,
|
|
23
|
+
installCommands,
|
|
24
|
+
};
|
|
25
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAoB,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAuB,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,eAAe,EAAE,wBAAwB;IACzC,YAAY,EAAE,sBAAsB;IACpC,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,eAAe;CAC8C,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export interface InstallCommandsOptions {
|
|
2
|
+
/** Base CLI invocation. Default `cadence`. */
|
|
3
|
+
cadenceCommand?: string;
|
|
4
|
+
/** Override commands dir relative to root. Default `.claude/commands`. */
|
|
5
|
+
commandsDir?: string;
|
|
6
|
+
/**
|
|
7
|
+
* Use the absolute path to the local workspace core CLI instead of the
|
|
8
|
+
* `cadence` shorthand. Intended for monorepo dogfood before publishing.
|
|
9
|
+
*
|
|
10
|
+
* WARNING: the resulting `.claude/commands/cadence-*.md` files embed a
|
|
11
|
+
* MACHINE-ABSOLUTE path and must NOT be committed — they break on every
|
|
12
|
+
* other clone/machine. The committed form must be the portable default
|
|
13
|
+
* (`cadence …`, written when `local` is omitted). The CLI emits a stderr
|
|
14
|
+
* warning naming this surface; see `docs/claude-code.md` § "The --local
|
|
15
|
+
* warning".
|
|
16
|
+
*/
|
|
17
|
+
local?: boolean;
|
|
18
|
+
}
|
|
19
|
+
export declare function installCommands(root: string, opts?: InstallCommandsOptions): Promise<void>;
|
|
20
|
+
//# sourceMappingURL=install-commands.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install-commands.d.ts","sourceRoot":"","sources":["../src/install-commands.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA6BD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CAoBf"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { COMMANDS } from '@thomas-powers-jr/cadence-host-toolkit';
|
|
4
|
+
import { resolveLocalPaths } from './locate-self.js';
|
|
5
|
+
const MANAGED_MARKER = '<!-- managed-by: cadence -->';
|
|
6
|
+
// The command catalog (which commands exist, their description/cli/
|
|
7
|
+
// argumentHint/trailing/body) now lives in the shared toolkit package,
|
|
8
|
+
// `@thomas-powers-jr/cadence-host-toolkit` (phase 222), so both host adapters
|
|
9
|
+
// render from the identical, undrifted catalog. Rendered output is
|
|
10
|
+
// byte-identical — guarded by tests/install-commands-parity.test.ts.
|
|
11
|
+
function renderFile(spec, cadenceCommand) {
|
|
12
|
+
const fm = ['---'];
|
|
13
|
+
fm.push(`description: ${spec.description}`);
|
|
14
|
+
if (spec.argumentHint)
|
|
15
|
+
fm.push(`argument-hint: ${spec.argumentHint}`);
|
|
16
|
+
fm.push('allowed-tools: Bash(cadence:*), Read');
|
|
17
|
+
fm.push('---');
|
|
18
|
+
const lines = [
|
|
19
|
+
fm.join('\n'),
|
|
20
|
+
'',
|
|
21
|
+
MANAGED_MARKER,
|
|
22
|
+
'',
|
|
23
|
+
`!${cadenceCommand} ${spec.cli}`.trimEnd(),
|
|
24
|
+
'',
|
|
25
|
+
];
|
|
26
|
+
if (spec.body)
|
|
27
|
+
lines.push(spec.body, '');
|
|
28
|
+
if (spec.trailing)
|
|
29
|
+
lines.push(spec.trailing, '');
|
|
30
|
+
return lines.join('\n');
|
|
31
|
+
}
|
|
32
|
+
export async function installCommands(root, opts = {}) {
|
|
33
|
+
const local = opts.local ? resolveLocalPaths() : null;
|
|
34
|
+
const cadenceCommand = opts.cadenceCommand ?? (local ? `node ${local.coreCli}` : 'cadence');
|
|
35
|
+
const dir = join(root, opts.commandsDir ?? '.claude/commands');
|
|
36
|
+
await mkdir(dir, { recursive: true });
|
|
37
|
+
for (const spec of COMMANDS) {
|
|
38
|
+
const path = join(dir, `${spec.name}.md`);
|
|
39
|
+
let existing = null;
|
|
40
|
+
try {
|
|
41
|
+
existing = await readFile(path, 'utf8');
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
// missing — create fresh
|
|
45
|
+
}
|
|
46
|
+
if (existing !== null && !existing.includes(MANAGED_MARKER)) {
|
|
47
|
+
// User-customized; leave it alone.
|
|
48
|
+
continue;
|
|
49
|
+
}
|
|
50
|
+
await writeFile(path, renderFile(spec, cadenceCommand), 'utf8');
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
//# sourceMappingURL=install-commands.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install-commands.js","sourceRoot":"","sources":["../src/install-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAoB,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAqBrD,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAEtD,oEAAoE;AACpE,uEAAuE;AACvE,8EAA8E;AAC9E,mEAAmE;AACnE,qEAAqE;AAErE,SAAS,UAAU,CAAC,IAAiB,EAAE,cAAsB;IAC3D,MAAM,EAAE,GAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,EAAE,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,YAAY;QAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACtE,EAAE,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAChD,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,MAAM,KAAK,GAAG;QACZ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QACb,EAAE;QACF,cAAc;QACd,EAAE;QACF,IAAI,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE;QAC1C,EAAE;KACH,CAAC;IACF,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAA+B,EAAE;IAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC,CAAC;IAC/D,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5D,mCAAmC;YACnC,SAAS;QACX,CAAC;QACD,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
export interface InstallOptions {
|
|
2
|
+
/**
|
|
3
|
+
* Shim command that Claude Code invokes for every hook event. The shim
|
|
4
|
+
* reads stdin, translates payloads, and spawns the core CLI.
|
|
5
|
+
* Default: `npx @thomas-powers-jr/cadence-host-claude-code hook`.
|
|
6
|
+
*/
|
|
7
|
+
command?: string;
|
|
8
|
+
/**
|
|
9
|
+
* Base command the shim itself should use to invoke `@thomas-powers-jr/cadence-core`.
|
|
10
|
+
* If set, appended as `--cadence "<cmd>"` to the shim command.
|
|
11
|
+
* Default: shim's own default (`npx @thomas-powers-jr/cadence-core`).
|
|
12
|
+
*/
|
|
13
|
+
cadenceCommand?: string;
|
|
14
|
+
/** Path to settings file relative to root. Defaults to `.claude/settings.json`. */
|
|
15
|
+
settingsPath?: string;
|
|
16
|
+
/**
|
|
17
|
+
* Use absolute paths to the local workspace builds instead of `npx`-style
|
|
18
|
+
* defaults. Intended for monorepo dogfood before the package is published.
|
|
19
|
+
*/
|
|
20
|
+
local?: boolean;
|
|
21
|
+
}
|
|
22
|
+
export declare function installHooks(root: string, opts?: InstallOptions): Promise<void>;
|
|
23
|
+
//# sourceMappingURL=install.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkBD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFzF"}
|
package/dist/install.js
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { dirname, join } from 'node:path';
|
|
3
|
+
import { isCadenceManagedEntry, mergeManagedHookEntries } from '@thomas-powers-jr/cadence-host-toolkit/install-merge';
|
|
4
|
+
import { EDIT_TOOL_MATCHER, SKILL_TOOL_MATCHER } from './event-map.js';
|
|
5
|
+
import { resolveLocalPaths } from './locate-self.js';
|
|
6
|
+
/**
|
|
7
|
+
* Pre-Phase-12 installs tagged entries with `_managedBy: 'keel'`. Phase 18.1
|
|
8
|
+
* evicts those on re-install so the rename completes operationally and old
|
|
9
|
+
* `@keel/host-claude-code` shim invocations stop firing.
|
|
10
|
+
*/
|
|
11
|
+
function isLegacyKeelEntry(entry) {
|
|
12
|
+
return entry._managedBy === 'keel';
|
|
13
|
+
}
|
|
14
|
+
export async function installHooks(root, opts = {}) {
|
|
15
|
+
const local = opts.local ? resolveLocalPaths() : null;
|
|
16
|
+
const base = opts.command ?? (local ? `node ${local.shimCli} hook` : 'npx @thomas-powers-jr/cadence-host-claude-code hook');
|
|
17
|
+
const cadenceCommand = opts.cadenceCommand ?? (local ? `node ${local.coreCli}` : undefined);
|
|
18
|
+
const command = cadenceCommand ? `${base} --cadence "${cadenceCommand}"` : base;
|
|
19
|
+
const settingsPath = join(root, opts.settingsPath ?? '.claude/settings.json');
|
|
20
|
+
let current = {};
|
|
21
|
+
let raw;
|
|
22
|
+
try {
|
|
23
|
+
raw = await readFile(settingsPath, 'utf8');
|
|
24
|
+
}
|
|
25
|
+
catch (err) {
|
|
26
|
+
if (err.code === 'ENOENT') {
|
|
27
|
+
// file absent → start fresh, same as today's fresh-install behavior
|
|
28
|
+
raw = undefined;
|
|
29
|
+
}
|
|
30
|
+
else {
|
|
31
|
+
throw new Error(`Refusing to install: ${settingsPath} could not be read (${err.message}). ` +
|
|
32
|
+
`Fix or remove the file manually before re-running install.`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
if (raw !== undefined) {
|
|
36
|
+
try {
|
|
37
|
+
current = JSON.parse(raw);
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
throw new Error(`Refusing to install: ${settingsPath} exists but is not valid JSON. ` +
|
|
41
|
+
`Fix or remove the file manually before re-running install.`);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
if (typeof current !== 'object' || current === null || Array.isArray(current))
|
|
45
|
+
current = {};
|
|
46
|
+
const plain = () => ({
|
|
47
|
+
hooks: [{ type: 'command', command }],
|
|
48
|
+
_managedBy: 'cadence',
|
|
49
|
+
});
|
|
50
|
+
const matched = (matcher) => ({
|
|
51
|
+
matcher,
|
|
52
|
+
hooks: [{ type: 'command', command }],
|
|
53
|
+
_managedBy: 'cadence',
|
|
54
|
+
});
|
|
55
|
+
// Phase 23.4 — PostToolUse has two cadence-managed entries: one for edit
|
|
56
|
+
// tools (post-tool-edit abstract) and one for the Skill tool (skill-invoke).
|
|
57
|
+
const desired = {
|
|
58
|
+
SessionStart: [plain()],
|
|
59
|
+
UserPromptSubmit: [plain()],
|
|
60
|
+
PreToolUse: [matched(EDIT_TOOL_MATCHER)],
|
|
61
|
+
PostToolUse: [matched(EDIT_TOOL_MATCHER), matched(SKILL_TOOL_MATCHER)],
|
|
62
|
+
Stop: [plain()],
|
|
63
|
+
SubagentStop: [plain()],
|
|
64
|
+
SubagentStart: [plain()],
|
|
65
|
+
};
|
|
66
|
+
current.hooks = mergeManagedHookEntries(current.hooks ?? {}, desired, (e) => isCadenceManagedEntry(e) || isLegacyKeelEntry(e));
|
|
67
|
+
await mkdir(dirname(settingsPath), { recursive: true });
|
|
68
|
+
// Phase 171 — before overwriting a prior settings file, preserve it under a
|
|
69
|
+
// timestamped backup path. `raw !== undefined` here means the file existed
|
|
70
|
+
// AND parsed as valid JSON above (malformed JSON already threw earlier), so
|
|
71
|
+
// this is the only case where a prior file's content could be clobbered.
|
|
72
|
+
if (raw !== undefined) {
|
|
73
|
+
const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
|
|
74
|
+
const backupPath = `${settingsPath}.bak-${timestamp}`;
|
|
75
|
+
await writeFile(backupPath, raw, 'utf8');
|
|
76
|
+
}
|
|
77
|
+
// Write atomically: stage the new content in a temp file in the same
|
|
78
|
+
// directory, then rename it over the real path. `rename` on the same
|
|
79
|
+
// filesystem is atomic, so a crash mid-write never leaves `settingsPath`
|
|
80
|
+
// truncated or partially written.
|
|
81
|
+
const tempPath = `${settingsPath}.tmp-${process.pid}-${Date.now()}`;
|
|
82
|
+
await writeFile(tempPath, JSON.stringify(current, null, 2) + '\n', 'utf8');
|
|
83
|
+
await rename(tempPath, settingsPath);
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=install.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { LocalPaths } from '@thomas-powers-jr/cadence-host-toolkit/locate-self';
|
|
2
|
+
export type { LocalPaths };
|
|
3
|
+
/**
|
|
4
|
+
* Resolves absolute paths to the local (workspace) builds of this adapter
|
|
5
|
+
* and `@thomas-powers-jr/cadence-core`. Designed to work both at runtime (running
|
|
6
|
+
* from `packages/host-claude-code/dist/locate-self.js`) and under vitest
|
|
7
|
+
* (running from `packages/host-claude-code/src/locate-self.ts`).
|
|
8
|
+
*
|
|
9
|
+
* Thin wrapper (phase 222) around the shared toolkit implementation — the
|
|
10
|
+
* only adapter-specific bit is passing *this* module's own `import.meta.url`
|
|
11
|
+
* so the shared function anchors to host-claude-code's own package root.
|
|
12
|
+
*/
|
|
13
|
+
export declare function resolveLocalPaths(): LocalPaths;
|
|
14
|
+
//# sourceMappingURL=locate-self.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"locate-self.d.ts","sourceRoot":"","sources":["../src/locate-self.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAErF,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { resolveAdapterLocalPaths } from '@thomas-powers-jr/cadence-host-toolkit/locate-self';
|
|
2
|
+
/**
|
|
3
|
+
* Resolves absolute paths to the local (workspace) builds of this adapter
|
|
4
|
+
* and `@thomas-powers-jr/cadence-core`. Designed to work both at runtime (running
|
|
5
|
+
* from `packages/host-claude-code/dist/locate-self.js`) and under vitest
|
|
6
|
+
* (running from `packages/host-claude-code/src/locate-self.ts`).
|
|
7
|
+
*
|
|
8
|
+
* Thin wrapper (phase 222) around the shared toolkit implementation — the
|
|
9
|
+
* only adapter-specific bit is passing *this* module's own `import.meta.url`
|
|
10
|
+
* so the shared function anchors to host-claude-code's own package root.
|
|
11
|
+
*/
|
|
12
|
+
export function resolveLocalPaths() {
|
|
13
|
+
return resolveAdapterLocalPaths(import.meta.url);
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=locate-self.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"locate-self.js","sourceRoot":"","sources":["../src/locate-self.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAK9F;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC"}
|
package/dist/shim.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC"}
|
package/dist/shim.js
ADDED
package/dist/shim.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shim.js","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@thomas-powers-jr/cadence-host-claude-code",
|
|
3
|
+
"version": "1.54.0",
|
|
4
|
+
"engines": {
|
|
5
|
+
"node": ">=22"
|
|
6
|
+
},
|
|
7
|
+
"description": "Claude Code adapter for CADENCE — installs lifecycle hooks and slash commands that drive the CADENCE engine from inside Claude Code.",
|
|
8
|
+
"license": "MIT",
|
|
9
|
+
"author": "Thomas Powers",
|
|
10
|
+
"homepage": "https://github.com/thomas-powers-jr/cadence#readme",
|
|
11
|
+
"bugs": "https://github.com/thomas-powers-jr/cadence/issues",
|
|
12
|
+
"keywords": [
|
|
13
|
+
"cadence",
|
|
14
|
+
"claude",
|
|
15
|
+
"claude-code",
|
|
16
|
+
"ai",
|
|
17
|
+
"agents",
|
|
18
|
+
"hooks",
|
|
19
|
+
"slash-commands"
|
|
20
|
+
],
|
|
21
|
+
"type": "module",
|
|
22
|
+
"main": "./dist/index.js",
|
|
23
|
+
"types": "./dist/index.d.ts",
|
|
24
|
+
"exports": {
|
|
25
|
+
".": {
|
|
26
|
+
"import": "./dist/index.js",
|
|
27
|
+
"types": "./dist/index.d.ts"
|
|
28
|
+
}
|
|
29
|
+
},
|
|
30
|
+
"bin": {
|
|
31
|
+
"cadence-host-claude-code": "./bin/cadence-host-claude-code.cjs"
|
|
32
|
+
},
|
|
33
|
+
"files": [
|
|
34
|
+
"dist",
|
|
35
|
+
"bin",
|
|
36
|
+
"!dist/tsconfig.tsbuildinfo"
|
|
37
|
+
],
|
|
38
|
+
"publishConfig": {
|
|
39
|
+
"access": "public"
|
|
40
|
+
},
|
|
41
|
+
"repository": {
|
|
42
|
+
"type": "git",
|
|
43
|
+
"url": "git+https://github.com/thomas-powers-jr/cadence.git",
|
|
44
|
+
"directory": "packages/host-claude-code"
|
|
45
|
+
},
|
|
46
|
+
"dependencies": {
|
|
47
|
+
"commander": "^14.0.0",
|
|
48
|
+
"@thomas-powers-jr/cadence-core": "1.54.0",
|
|
49
|
+
"@thomas-powers-jr/cadence-host-toolkit": "1.54.0",
|
|
50
|
+
"@thomas-powers-jr/cadence-types": "1.54.0"
|
|
51
|
+
},
|
|
52
|
+
"devDependencies": {
|
|
53
|
+
"vitest": "^2.1.0",
|
|
54
|
+
"@thomas-powers-jr/cadence-testkit": "1.4.0"
|
|
55
|
+
},
|
|
56
|
+
"scripts": {
|
|
57
|
+
"build": "tsc -p tsconfig.json",
|
|
58
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
59
|
+
"test": "vitest run",
|
|
60
|
+
"lint": "eslint src",
|
|
61
|
+
"clean": "rm -rf dist .turbo"
|
|
62
|
+
}
|
|
63
|
+
}
|