@lkangd/cc-env 1.0.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.
Files changed (111) hide show
  1. package/.claude/settings.json +6 -0
  2. package/.claude/settings.local.json +3 -0
  3. package/.nvmrc +1 -0
  4. package/dist/cli.js +266 -0
  5. package/dist/commands/debug.js +17 -0
  6. package/dist/commands/init.js +64 -0
  7. package/dist/commands/preset/create.js +61 -0
  8. package/dist/commands/preset/delete.js +25 -0
  9. package/dist/commands/preset/edit.js +15 -0
  10. package/dist/commands/preset/list.js +16 -0
  11. package/dist/commands/preset/show.js +16 -0
  12. package/dist/commands/restore.js +65 -0
  13. package/dist/commands/run.js +80 -0
  14. package/dist/core/errors.js +11 -0
  15. package/dist/core/find-claude.js +64 -0
  16. package/dist/core/format.js +23 -0
  17. package/dist/core/fs.js +12 -0
  18. package/dist/core/gitignore.js +23 -0
  19. package/dist/core/lock.js +25 -0
  20. package/dist/core/logger.js +8 -0
  21. package/dist/core/mask.js +13 -0
  22. package/dist/core/paths.js +32 -0
  23. package/dist/core/process-env.js +4 -0
  24. package/dist/core/schema.js +38 -0
  25. package/dist/core/spawn.js +26 -0
  26. package/dist/flows/init-flow.js +35 -0
  27. package/dist/flows/preset-create-flow.js +80 -0
  28. package/dist/flows/restore-flow.js +75 -0
  29. package/dist/ink/init-app.js +54 -0
  30. package/dist/ink/preset-create-app.js +271 -0
  31. package/dist/ink/preset-delete-app.js +47 -0
  32. package/dist/ink/preset-list-app.js +27 -0
  33. package/dist/ink/preset-show-app.js +27 -0
  34. package/dist/ink/restore-app.js +102 -0
  35. package/dist/ink/run-preset-select-app.js +31 -0
  36. package/dist/ink/summary.js +28 -0
  37. package/dist/services/claude-settings-env-service.js +55 -0
  38. package/dist/services/config-service.js +26 -0
  39. package/dist/services/history-service.js +39 -0
  40. package/dist/services/preset-service.js +61 -0
  41. package/dist/services/project-env-service.js +90 -0
  42. package/dist/services/project-state-service.js +26 -0
  43. package/dist/services/runtime-env-service.js +13 -0
  44. package/dist/services/settings-env-service.js +36 -0
  45. package/dist/services/shell-env-service.js +77 -0
  46. package/docs/product-specs/index.draft.md +106 -0
  47. package/docs/product-specs/index.md +911 -0
  48. package/docs/product-specs/optional.md +42 -0
  49. package/docs/references/claude-code-env.md +224 -0
  50. package/docs/superpowers/plans/2026-04-24-cc-env-init-shell-migration.md +1331 -0
  51. package/docs/superpowers/plans/2026-04-24-cc-env.md +1666 -0
  52. package/docs/superpowers/plans/2026-04-26-preset-create-interactive-refactor.md +1432 -0
  53. package/docs/superpowers/specs/2026-04-24-cc-env-design.md +438 -0
  54. package/docs/superpowers/specs/2026-04-24-cc-env-init-shell-migration-design.md +181 -0
  55. package/docs/superpowers/specs/2026-04-26-preset-create-interactive-refactor-design.md +78 -0
  56. package/package.json +55 -0
  57. package/src/cli.ts +337 -0
  58. package/src/commands/init.ts +139 -0
  59. package/src/commands/preset/create.ts +96 -0
  60. package/src/commands/preset/delete.ts +62 -0
  61. package/src/commands/preset/show.ts +51 -0
  62. package/src/commands/restore.ts +150 -0
  63. package/src/commands/run.ts +158 -0
  64. package/src/core/errors.ts +13 -0
  65. package/src/core/find-claude.ts +70 -0
  66. package/src/core/format.ts +29 -0
  67. package/src/core/fs.ts +18 -0
  68. package/src/core/gitignore.ts +26 -0
  69. package/src/core/logger.ts +11 -0
  70. package/src/core/mask.ts +17 -0
  71. package/src/core/paths.ts +41 -0
  72. package/src/core/process-env.ts +11 -0
  73. package/src/core/schema.ts +55 -0
  74. package/src/core/spawn.ts +36 -0
  75. package/src/flows/init-flow.ts +61 -0
  76. package/src/flows/preset-create-flow.ts +129 -0
  77. package/src/flows/restore-flow.ts +144 -0
  78. package/src/ink/init-app.tsx +110 -0
  79. package/src/ink/preset-create-app.tsx +451 -0
  80. package/src/ink/preset-delete-app.tsx +114 -0
  81. package/src/ink/preset-show-app.tsx +76 -0
  82. package/src/ink/restore-app.tsx +230 -0
  83. package/src/ink/run-preset-select-app.tsx +83 -0
  84. package/src/ink/summary.tsx +91 -0
  85. package/src/services/claude-settings-env-service.ts +72 -0
  86. package/src/services/history-service.ts +48 -0
  87. package/src/services/preset-service.ts +72 -0
  88. package/src/services/project-env-service.ts +128 -0
  89. package/src/services/project-state-service.ts +31 -0
  90. package/src/services/settings-env-service.ts +40 -0
  91. package/src/services/shell-env-service.ts +112 -0
  92. package/src/types.d.ts +19 -0
  93. package/tests/cli/help.test.ts +133 -0
  94. package/tests/cli/init.test.ts +76 -0
  95. package/tests/cli/restore.test.ts +172 -0
  96. package/tests/commands/create.test.ts +263 -0
  97. package/tests/commands/output.test.ts +119 -0
  98. package/tests/commands/run.test.ts +218 -0
  99. package/tests/core/gitignore.test.ts +98 -0
  100. package/tests/core/paths.test.ts +24 -0
  101. package/tests/core/schema-mask.test.ts +182 -0
  102. package/tests/core/spawn.test.ts +47 -0
  103. package/tests/flows/init-flow.test.ts +40 -0
  104. package/tests/flows/preset-create-flow.test.ts +225 -0
  105. package/tests/flows/restore-flow.test.ts +157 -0
  106. package/tests/integration/init-restore.test.ts +406 -0
  107. package/tests/services/claude-shell.test.ts +183 -0
  108. package/tests/services/storage.test.ts +143 -0
  109. package/tsconfig.build.json +9 -0
  110. package/tsconfig.json +22 -0
  111. package/vitest.config.ts +8 -0
@@ -0,0 +1,143 @@
1
+ import { access, mkdtemp, readdir, rm } from 'node:fs/promises'
2
+ import { dirname, join } from 'node:path'
3
+ import { tmpdir } from 'node:os'
4
+
5
+ import { afterEach, describe, expect, it } from 'vitest'
6
+
7
+ import { atomicWriteFile } from '../../src/core/fs.js'
8
+ import { CliError } from '../../src/core/errors.js'
9
+ import type { HistoryRecord } from '../../src/core/schema.js'
10
+ import { createHistoryService } from '../../src/services/history-service.js'
11
+ import { createPresetService } from '../../src/services/preset-service.js'
12
+
13
+ const tempRoots: string[] = []
14
+
15
+ async function createTempRoot(): Promise<string> {
16
+ const root = await mkdtemp(join(tmpdir(), 'cc-env-storage-'))
17
+ tempRoots.push(root)
18
+ return root
19
+ }
20
+
21
+ afterEach(async () => {
22
+ await Promise.all(tempRoots.splice(0).map((root) => rm(root, { recursive: true, force: true })))
23
+ })
24
+
25
+ describe('atomicWriteFile', () => {
26
+ it('replaces the target file without leaving temp files behind', async () => {
27
+ const globalRoot = await createTempRoot()
28
+ const filePath = join(globalRoot, 'config.json')
29
+
30
+ await atomicWriteFile(filePath, '{"defaultPreset":"openai"}\n')
31
+
32
+ await expect(access(filePath)).resolves.toBeUndefined()
33
+ await expect(access(`${filePath}.tmp`)).rejects.toMatchObject({ code: 'ENOENT' })
34
+
35
+ const entries = await readdir(dirname(filePath))
36
+ expect(entries).toEqual(['config.json'])
37
+ })
38
+ })
39
+
40
+ describe('preset service', () => {
41
+ it('writes, reads, lists names, removes, and throws when preset is missing', async () => {
42
+ const globalRoot = await createTempRoot()
43
+ const service = createPresetService(globalRoot)
44
+
45
+ await expect(
46
+ service.write({
47
+ name: 'openai',
48
+ createdAt: '2026-04-24T12:00:00.000Z',
49
+ updatedAt: '2026-04-24T12:00:00.000Z',
50
+ env: {
51
+ OPENAI_API_KEY: 'sk-123',
52
+ },
53
+ }),
54
+ ).resolves.toMatchObject({
55
+ name: 'openai',
56
+ filePath: expect.stringContaining('presets/openai.json'),
57
+ })
58
+
59
+ await expect(service.read('openai')).resolves.toMatchObject({
60
+ name: 'openai',
61
+ filePath: expect.stringContaining('presets/openai.json'),
62
+ })
63
+ await expect(service.listNames()).resolves.toEqual(['openai'])
64
+
65
+ await service.remove('openai')
66
+
67
+ await expect(service.listNames()).resolves.toEqual([])
68
+ await expect(service.read('openai')).rejects.toThrowError(new CliError('Preset not found: openai'))
69
+ })
70
+ })
71
+
72
+ describe('history service', () => {
73
+ it('writes restore records and lists them with targetName preserved', async () => {
74
+ const globalRoot = await createTempRoot()
75
+ const service = createHistoryService(globalRoot)
76
+
77
+ await service.write({
78
+ action: 'restore',
79
+ targetType: 'preset',
80
+ targetName: 'openai',
81
+ timestamp: '2026-04-24T12:34:56.000Z',
82
+ backup: {
83
+ OPENAI_API_KEY: 'sk-123',
84
+ },
85
+ })
86
+
87
+ await expect(service.list()).resolves.toEqual([
88
+ {
89
+ action: 'restore',
90
+ targetType: 'preset',
91
+ targetName: 'openai',
92
+ timestamp: '2026-04-24T12:34:56.000Z',
93
+ backup: {
94
+ OPENAI_API_KEY: 'sk-123',
95
+ },
96
+ },
97
+ ])
98
+ })
99
+
100
+ it('persists expanded init history records', async () => {
101
+ const globalRoot = await createTempRoot()
102
+ const service = createHistoryService(globalRoot)
103
+
104
+ const record: HistoryRecord = {
105
+ timestamp: '2026-04-24T10:00:00.000Z',
106
+ action: 'init',
107
+ migratedKeys: ['ANTHROPIC_AUTH_TOKEN'],
108
+ sources: [
109
+ {
110
+ file: '/Users/test/.claude/settings.json',
111
+ backup: {},
112
+ },
113
+ {
114
+ file: '/Users/test/.claude/settings.local.json',
115
+ backup: {
116
+ ANTHROPIC_AUTH_TOKEN: 'local-token',
117
+ },
118
+ },
119
+ ],
120
+ shellWrites: [
121
+ {
122
+ shell: 'fish',
123
+ filePath: '/Users/test/.config/fish/config.fish',
124
+ env: {
125
+ ANTHROPIC_AUTH_TOKEN: 'local-token',
126
+ },
127
+ },
128
+ ],
129
+ }
130
+
131
+ await expect(service.write(record)).resolves.toEqual(record)
132
+ await expect(service.list()).resolves.toMatchObject([
133
+ {
134
+ action: 'init',
135
+ shellWrites: [
136
+ {
137
+ shell: 'fish',
138
+ },
139
+ ],
140
+ },
141
+ ])
142
+ })
143
+ })
@@ -0,0 +1,9 @@
1
+ {
2
+ "extends": "./tsconfig.json",
3
+ "compilerOptions": {
4
+ "noEmit": false,
5
+ "rootDir": "src",
6
+ "outDir": "dist"
7
+ },
8
+ "include": ["src/**/*.ts"]
9
+ }
package/tsconfig.json ADDED
@@ -0,0 +1,22 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "NodeNext",
5
+ "moduleResolution": "NodeNext",
6
+ "lib": ["ES2022"],
7
+ "strict": true,
8
+ "noImplicitOverride": true,
9
+ "noUncheckedIndexedAccess": true,
10
+ "exactOptionalPropertyTypes": true,
11
+ "forceConsistentCasingInFileNames": true,
12
+ "isolatedModules": true,
13
+ "esModuleInterop": true,
14
+ "skipLibCheck": true,
15
+ "resolveJsonModule": true,
16
+ "jsx": "react-jsx",
17
+ "types": ["node", "vitest/globals"],
18
+ "noEmit": true
19
+ },
20
+ "include": ["src/**/*.ts", "tests/**/*.ts"],
21
+ "exclude": ["dist", "node_modules"]
22
+ }
@@ -0,0 +1,8 @@
1
+ import { defineConfig } from 'vitest/config'
2
+
3
+ export default defineConfig({
4
+ test: {
5
+ environment: 'node',
6
+ include: ['tests/**/*.test.ts'],
7
+ },
8
+ })