@spekn/cli 1.0.0 → 1.0.2

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 (154) hide show
  1. package/README.md +58 -0
  2. package/dist/main.js +40540 -32176
  3. package/dist/prompts/governance-analysis.prompt.md +109 -0
  4. package/dist/resources/prompts/repo-analysis.prompt.md +28 -136
  5. package/dist/resources/prompts/repo-sync-analysis.prompt.md +31 -68
  6. package/dist/tui/chunk-4WEASLXY.mjs +3444 -0
  7. package/dist/tui/chunk-755CADEG.mjs +3401 -0
  8. package/dist/tui/chunk-BUJQVTY5.mjs +3409 -0
  9. package/dist/tui/chunk-BZKKMGFB.mjs +1959 -0
  10. package/dist/tui/chunk-DJYOBCNM.mjs +3159 -0
  11. package/dist/tui/chunk-GTFTFDY4.mjs +3417 -0
  12. package/dist/tui/chunk-IMEBD2KA.mjs +3444 -0
  13. package/dist/tui/chunk-IX6DR5SW.mjs +3433 -0
  14. package/dist/tui/chunk-JKFOY4IF.mjs +2003 -0
  15. package/dist/tui/chunk-OXXZ3O5L.mjs +3378 -0
  16. package/dist/tui/chunk-SHJNIAAJ.mjs +1697 -0
  17. package/dist/tui/chunk-V4SNDRUS.mjs +1666 -0
  18. package/dist/tui/chunk-VXVHNZST.mjs +1666 -0
  19. package/dist/tui/chunk-WCTSFKTA.mjs +3459 -0
  20. package/dist/tui/chunk-X2XP5ACW.mjs +3443 -0
  21. package/dist/tui/chunk-YUYJ7VBG.mjs +2029 -0
  22. package/dist/tui/chunk-ZM3EI5IA.mjs +3384 -0
  23. package/dist/tui/chunk-ZYOX64HP.mjs +1653 -0
  24. package/dist/tui/index.mjs +6999 -6938
  25. package/dist/tui/prompts/spec-creation-system.prompt.md +47 -0
  26. package/dist/tui/prompts/spec-refinement-system.prompt.md +72 -0
  27. package/dist/tui/use-session-store-63YUGUFA.mjs +8 -0
  28. package/dist/tui/use-session-store-ACO2SMJC.mjs +8 -0
  29. package/dist/tui/use-session-store-BVFDAWOB.mjs +8 -0
  30. package/dist/tui/use-session-store-DJIZ3FQZ.mjs +9 -0
  31. package/dist/tui/use-session-store-EAIQA4UG.mjs +9 -0
  32. package/dist/tui/use-session-store-EFBAXC3G.mjs +8 -0
  33. package/dist/tui/use-session-store-FJOR4KTG.mjs +8 -0
  34. package/dist/tui/use-session-store-IJE5KVOC.mjs +8 -0
  35. package/dist/tui/use-session-store-KGAFXCKI.mjs +8 -0
  36. package/dist/tui/use-session-store-KS4DPNDY.mjs +8 -0
  37. package/dist/tui/use-session-store-MMHJENNL.mjs +8 -0
  38. package/dist/tui/use-session-store-OZ6HC4I2.mjs +9 -0
  39. package/dist/tui/use-session-store-PTMWISNJ.mjs +8 -0
  40. package/dist/tui/use-session-store-VCDECQMW.mjs +8 -0
  41. package/dist/tui/use-session-store-VOK5ML5J.mjs +9 -0
  42. package/package.json +33 -13
  43. package/dist/__tests__/export-cli.test.d.ts +0 -1
  44. package/dist/__tests__/export-cli.test.js +0 -70
  45. package/dist/__tests__/tui-args-policy.test.d.ts +0 -1
  46. package/dist/__tests__/tui-args-policy.test.js +0 -50
  47. package/dist/acp-S2MHZOAD.mjs +0 -23
  48. package/dist/acp-UCCI44JY.mjs +0 -25
  49. package/dist/auth/credentials-store.d.ts +0 -2
  50. package/dist/auth/credentials-store.js +0 -5
  51. package/dist/auth/device-flow.d.ts +0 -36
  52. package/dist/auth/device-flow.js +0 -189
  53. package/dist/auth/jwt.d.ts +0 -1
  54. package/dist/auth/jwt.js +0 -6
  55. package/dist/auth/session.d.ts +0 -67
  56. package/dist/auth/session.js +0 -86
  57. package/dist/auth-login.d.ts +0 -34
  58. package/dist/auth-login.js +0 -202
  59. package/dist/auth-logout.d.ts +0 -25
  60. package/dist/auth-logout.js +0 -115
  61. package/dist/auth-status.d.ts +0 -24
  62. package/dist/auth-status.js +0 -109
  63. package/dist/backlog-generate.d.ts +0 -11
  64. package/dist/backlog-generate.js +0 -308
  65. package/dist/backlog-health.d.ts +0 -11
  66. package/dist/backlog-health.js +0 -287
  67. package/dist/bridge-login.d.ts +0 -40
  68. package/dist/bridge-login.js +0 -277
  69. package/dist/chunk-3PAYRI4G.mjs +0 -2428
  70. package/dist/chunk-M4CS3A25.mjs +0 -2426
  71. package/dist/commands/auth/login.d.ts +0 -30
  72. package/dist/commands/auth/login.js +0 -164
  73. package/dist/commands/auth/logout.d.ts +0 -25
  74. package/dist/commands/auth/logout.js +0 -115
  75. package/dist/commands/auth/status.d.ts +0 -24
  76. package/dist/commands/auth/status.js +0 -109
  77. package/dist/commands/backlog/generate.d.ts +0 -11
  78. package/dist/commands/backlog/generate.js +0 -308
  79. package/dist/commands/backlog/health.d.ts +0 -11
  80. package/dist/commands/backlog/health.js +0 -287
  81. package/dist/commands/bridge/login.d.ts +0 -36
  82. package/dist/commands/bridge/login.js +0 -258
  83. package/dist/commands/export.d.ts +0 -35
  84. package/dist/commands/export.js +0 -485
  85. package/dist/commands/marketplace-export.d.ts +0 -21
  86. package/dist/commands/marketplace-export.js +0 -214
  87. package/dist/commands/project-clean.d.ts +0 -1
  88. package/dist/commands/project-clean.js +0 -126
  89. package/dist/commands/repo/common.d.ts +0 -105
  90. package/dist/commands/repo/common.js +0 -775
  91. package/dist/commands/repo/detach.d.ts +0 -2
  92. package/dist/commands/repo/detach.js +0 -120
  93. package/dist/commands/repo/register.d.ts +0 -21
  94. package/dist/commands/repo/register.js +0 -175
  95. package/dist/commands/repo/sync.d.ts +0 -22
  96. package/dist/commands/repo/sync.js +0 -873
  97. package/dist/commands/skills-import-local.d.ts +0 -16
  98. package/dist/commands/skills-import-local.js +0 -352
  99. package/dist/commands/spec/drift-check.d.ts +0 -3
  100. package/dist/commands/spec/drift-check.js +0 -186
  101. package/dist/commands/spec/frontmatter.d.ts +0 -11
  102. package/dist/commands/spec/frontmatter.js +0 -219
  103. package/dist/commands/spec/lint.d.ts +0 -11
  104. package/dist/commands/spec/lint.js +0 -499
  105. package/dist/commands/spec/parse.d.ts +0 -11
  106. package/dist/commands/spec/parse.js +0 -162
  107. package/dist/export.d.ts +0 -35
  108. package/dist/export.js +0 -485
  109. package/dist/main.d.ts +0 -1
  110. package/dist/marketplace-export.d.ts +0 -21
  111. package/dist/marketplace-export.js +0 -214
  112. package/dist/project-clean.d.ts +0 -1
  113. package/dist/project-clean.js +0 -126
  114. package/dist/project-context.d.ts +0 -99
  115. package/dist/project-context.js +0 -376
  116. package/dist/repo-common.d.ts +0 -101
  117. package/dist/repo-common.js +0 -671
  118. package/dist/repo-detach.d.ts +0 -2
  119. package/dist/repo-detach.js +0 -102
  120. package/dist/repo-ingest.d.ts +0 -29
  121. package/dist/repo-ingest.js +0 -305
  122. package/dist/repo-register.d.ts +0 -21
  123. package/dist/repo-register.js +0 -175
  124. package/dist/repo-sync.d.ts +0 -16
  125. package/dist/repo-sync.js +0 -152
  126. package/dist/resources/prompt-loader.d.ts +0 -1
  127. package/dist/resources/prompt-loader.js +0 -62
  128. package/dist/skills-import-local.d.ts +0 -16
  129. package/dist/skills-import-local.js +0 -352
  130. package/dist/spec-drift-check.d.ts +0 -3
  131. package/dist/spec-drift-check.js +0 -186
  132. package/dist/spec-frontmatter.d.ts +0 -11
  133. package/dist/spec-frontmatter.js +0 -219
  134. package/dist/spec-lint.d.ts +0 -11
  135. package/dist/spec-lint.js +0 -499
  136. package/dist/spec-parse.d.ts +0 -11
  137. package/dist/spec-parse.js +0 -162
  138. package/dist/stubs/dotenv.d.ts +0 -5
  139. package/dist/stubs/dotenv.js +0 -6
  140. package/dist/stubs/typeorm.d.ts +0 -22
  141. package/dist/stubs/typeorm.js +0 -28
  142. package/dist/tui-bundle.d.ts +0 -1
  143. package/dist/tui-bundle.js +0 -5
  144. package/dist/tui-entry.mjs +0 -1407
  145. package/dist/utils/cli-runtime.d.ts +0 -5
  146. package/dist/utils/cli-runtime.js +0 -22
  147. package/dist/utils/help-error.d.ts +0 -7
  148. package/dist/utils/help-error.js +0 -14
  149. package/dist/utils/interaction.d.ts +0 -19
  150. package/dist/utils/interaction.js +0 -93
  151. package/dist/utils/structured-log.d.ts +0 -7
  152. package/dist/utils/structured-log.js +0 -112
  153. package/dist/utils/trpc-url.d.ts +0 -4
  154. package/dist/utils/trpc-url.js +0 -15
@@ -1,214 +0,0 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
4
- if (k2 === undefined) k2 = k;
5
- var desc = Object.getOwnPropertyDescriptor(m, k);
6
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
7
- desc = { enumerable: true, get: function() { return m[k]; } };
8
- }
9
- Object.defineProperty(o, k2, desc);
10
- }) : (function(o, m, k, k2) {
11
- if (k2 === undefined) k2 = k;
12
- o[k2] = m[k];
13
- }));
14
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
15
- Object.defineProperty(o, "default", { enumerable: true, value: v });
16
- }) : function(o, v) {
17
- o["default"] = v;
18
- });
19
- var __importStar = (this && this.__importStar) || (function () {
20
- var ownKeys = function(o) {
21
- ownKeys = Object.getOwnPropertyNames || function (o) {
22
- var ar = [];
23
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
24
- return ar;
25
- };
26
- return ownKeys(o);
27
- };
28
- return function (mod) {
29
- if (mod && mod.__esModule) return mod;
30
- var result = {};
31
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
32
- __setModuleDefault(result, mod);
33
- return result;
34
- };
35
- })();
36
- Object.defineProperty(exports, "__esModule", { value: true });
37
- exports.runMarketplaceExportCli = runMarketplaceExportCli;
38
- exports.main = main;
39
- exports.parseArgs = parseArgs;
40
- const client_1 = require("@trpc/client");
41
- const fs = __importStar(require("node:fs"));
42
- const path = __importStar(require("node:path"));
43
- const credentials_store_1 = require("./auth/credentials-store");
44
- const export_1 = require("./export");
45
- const project_context_1 = require("./project-context");
46
- const structured_log_1 = require("./utils/structured-log");
47
- const defaultDeps = {
48
- createClient: (apiUrl, organizationId, authToken) => (0, client_1.createTRPCProxyClient)({
49
- links: [
50
- (0, client_1.httpBatchLink)({
51
- url: (0, export_1.normalizeTrpcUrl)(apiUrl),
52
- headers: {
53
- 'x-organization-id': organizationId,
54
- authorization: authToken ? `Bearer ${authToken}` : '',
55
- },
56
- }),
57
- ],
58
- }),
59
- writeFile: (filePath, content) => {
60
- fs.writeFileSync(filePath, content, 'utf-8');
61
- },
62
- mkdirSync: (dirPath) => {
63
- fs.mkdirSync(dirPath, { recursive: true });
64
- },
65
- stdout: (content) => process.stdout.write(content),
66
- stderr: (content) => process.stderr.write(content),
67
- credentialsStore: new credentials_store_1.CredentialsStore(),
68
- };
69
- function printHelp(stderr) {
70
- stderr(`
71
- marketplace export - Export Claude Code-compatible plugin marketplace to disk
72
-
73
- USAGE:
74
- spekn marketplace export --project <uuid> [options]
75
-
76
- OPTIONS:
77
- --project <uuid> Project ID (optional if .spekn/context is present)
78
- --output <dir> Output directory (default: .)
79
- --api-url <url> API base URL (default: SPEKN_API_URL or https://app.spekn.com)
80
- --marketplace-name <name> Marketplace identifier (default: spekn-marketplace)
81
- --owner-name <name> Owner name (default: Spekn)
82
- --help Show help
83
- `);
84
- }
85
- function parseArgs(args) {
86
- let projectId = '';
87
- let output = '.';
88
- let apiUrl = process.env.SPEKN_API_URL || 'https://app.spekn.com';
89
- let marketplaceName = 'spekn-marketplace';
90
- let ownerName = 'Spekn';
91
- for (let index = 0; index < args.length; index++) {
92
- const arg = args[index];
93
- if (arg === '--help' || arg === '-h') {
94
- throw new Error('__HELP__');
95
- }
96
- if (arg === '--project' && args[index + 1]) {
97
- projectId = args[++index];
98
- continue;
99
- }
100
- if (arg.startsWith('--project=')) {
101
- projectId = arg.slice('--project='.length);
102
- continue;
103
- }
104
- if (arg === '--output' && args[index + 1]) {
105
- output = args[++index];
106
- continue;
107
- }
108
- if (arg.startsWith('--output=')) {
109
- output = arg.slice('--output='.length);
110
- continue;
111
- }
112
- if (arg === '--api-url' && args[index + 1]) {
113
- apiUrl = args[++index];
114
- continue;
115
- }
116
- if (arg.startsWith('--api-url=')) {
117
- apiUrl = arg.slice('--api-url='.length);
118
- continue;
119
- }
120
- if (arg === '--marketplace-name' && args[index + 1]) {
121
- marketplaceName = args[++index];
122
- continue;
123
- }
124
- if (arg.startsWith('--marketplace-name=')) {
125
- marketplaceName = arg.slice('--marketplace-name='.length);
126
- continue;
127
- }
128
- if (arg === '--owner-name' && args[index + 1]) {
129
- ownerName = args[++index];
130
- continue;
131
- }
132
- if (arg.startsWith('--owner-name=')) {
133
- ownerName = arg.slice('--owner-name='.length);
134
- continue;
135
- }
136
- }
137
- return {
138
- projectId,
139
- output,
140
- apiUrl,
141
- marketplaceName,
142
- ownerName,
143
- };
144
- }
145
- async function runMarketplaceExportCli(args, deps = defaultDeps) {
146
- try {
147
- const options = parseArgs(args);
148
- (0, structured_log_1.appendCliStructuredLog)({
149
- source: 'cli.marketplace.export',
150
- level: 'info',
151
- message: 'Starting marketplace export',
152
- details: { output: options.output, apiUrl: options.apiUrl, marketplaceName: options.marketplaceName },
153
- });
154
- const storedToken = await deps.credentialsStore.getValidToken();
155
- const authToken = storedToken ?? process.env.SPEKN_AUTH_TOKEN;
156
- const storedCreds = deps.credentialsStore.load();
157
- const context = (0, project_context_1.resolveProjectContext)({
158
- explicitProjectId: options.projectId,
159
- repoPath: process.cwd(),
160
- credentialsOrganizationId: storedCreds?.organizationId,
161
- envOrganizationId: process.env.SPEKN_ORGANIZATION_ID,
162
- });
163
- const client = deps.createClient(options.apiUrl, context.organizationId, authToken ?? undefined);
164
- const result = await client.marketplace.exportClaudeCodeCatalog.query({
165
- marketplaceName: options.marketplaceName,
166
- ownerName: options.ownerName,
167
- });
168
- const outputDir = path.resolve(process.cwd(), options.output);
169
- // Write marketplace.json
170
- const marketplaceDir = path.join(outputDir, '.claude-plugin');
171
- deps.mkdirSync(marketplaceDir);
172
- deps.writeFile(path.join(marketplaceDir, 'marketplace.json'), typeof result.json === 'string' ? result.json : JSON.stringify(result.json, null, 2));
173
- // Write per-plugin manifests
174
- for (const entry of result.entries) {
175
- const pluginDir = path.join(outputDir, 'plugins', entry.name, '.claude-plugin');
176
- deps.mkdirSync(pluginDir);
177
- deps.writeFile(path.join(pluginDir, 'plugin.json'), JSON.stringify({
178
- name: entry.name,
179
- description: entry.description,
180
- version: entry.version,
181
- author: entry.author,
182
- }, null, 2));
183
- }
184
- deps.stdout(`Exported ${result.pluginCount} plugins to ${outputDir}\n`);
185
- (0, structured_log_1.appendCliStructuredLog)({
186
- source: 'cli.marketplace.export',
187
- level: 'info',
188
- message: 'Marketplace export complete',
189
- details: { outputDir, pluginCount: result.pluginCount },
190
- });
191
- return 0;
192
- }
193
- catch (error) {
194
- if (error instanceof Error && error.message === '__HELP__') {
195
- printHelp(deps.stderr);
196
- return 0;
197
- }
198
- const message = error instanceof Error ? error.message : String(error);
199
- deps.stderr(`Error: ${message}\n`);
200
- (0, structured_log_1.appendCliStructuredLog)({
201
- source: 'cli.marketplace.export',
202
- level: 'error',
203
- message,
204
- });
205
- return 1;
206
- }
207
- }
208
- async function main() {
209
- const exitCode = await runMarketplaceExportCli(process.argv.slice(2));
210
- process.exit(exitCode);
211
- }
212
- if (require.main === module) {
213
- void main();
214
- }
@@ -1 +0,0 @@
1
- export declare function runProjectDeleteCli(args: string[]): Promise<number>;
@@ -1,126 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.runProjectDeleteCli = runProjectDeleteCli;
4
- const client_1 = require("@trpc/client");
5
- const credentials_store_1 = require("./auth/credentials-store");
6
- const trpc_url_1 = require("./utils/trpc-url");
7
- /**
8
- * Delete a project using the API. With the fixed foreign key constraints,
9
- * the database will automatically cascade delete all related entities.
10
- */
11
- async function deleteProject(projectId, apiUrl) {
12
- const credentialsStore = new credentials_store_1.CredentialsStore();
13
- const authToken = await credentialsStore.getValidToken();
14
- if (!authToken) {
15
- throw new Error("Not authenticated. Please run 'spekn auth login' first.");
16
- }
17
- const credentials = credentialsStore.load();
18
- const organizationId = credentials?.organizationId ?? "";
19
- const trpc = (0, client_1.createTRPCProxyClient)({
20
- links: [
21
- (0, client_1.httpBatchLink)({
22
- url: (0, trpc_url_1.normalizeTrpcUrl)(apiUrl),
23
- headers: {
24
- Authorization: `Bearer ${authToken}`,
25
- "x-organization-id": organizationId,
26
- },
27
- }),
28
- ],
29
- });
30
- console.log(`Deleting project ${projectId}...`);
31
- try {
32
- // With the fixed foreign key constraints, this single call will
33
- // automatically cascade delete all related entities
34
- await trpc.project.delete.mutate({ id: projectId });
35
- console.log(`✅ Project ${projectId} and all related entities have been successfully deleted.`);
36
- }
37
- catch (error) {
38
- console.error("❌ Error deleting project:", error);
39
- throw error;
40
- }
41
- }
42
- function printHelp() {
43
- console.log(`
44
- project delete - Delete a project and all its related entities
45
-
46
- USAGE:
47
- spekn project delete <project-id> [options]
48
-
49
- ARGUMENTS:
50
- <project-id> Project ID to delete
51
-
52
- OPTIONS:
53
- --api-url <url> API URL (default: SPEKN_API_URL or https://app.spekn.com)
54
- --force Skip confirmation prompt
55
- --help Show this help message
56
-
57
- EXAMPLES:
58
- spekn project delete 11111111-1111-4111-8111-111111111111
59
- spekn project delete 11111111-1111-4111-8111-111111111111 --force
60
- `);
61
- }
62
- async function runProjectDeleteCli(args) {
63
- // Parse arguments manually since we receive already-sliced args
64
- let projectId;
65
- let force = false;
66
- let apiUrl = process.env.SPEKN_API_URL ?? "https://app.spekn.com";
67
- for (let i = 0; i < args.length; i++) {
68
- const arg = args[i];
69
- if (arg === "--help" || arg === "-h") {
70
- printHelp();
71
- return 0;
72
- }
73
- if (arg === "--force") {
74
- force = true;
75
- continue;
76
- }
77
- if (arg === "--api-url" && args[i + 1]) {
78
- apiUrl = args[i + 1];
79
- i++; // skip next arg
80
- continue;
81
- }
82
- if (arg.startsWith("--api-url=")) {
83
- apiUrl = arg.slice("--api-url=".length);
84
- continue;
85
- }
86
- // Positional argument (project-id)
87
- if (!projectId && !arg.startsWith("--")) {
88
- projectId = arg;
89
- continue;
90
- }
91
- }
92
- // Validate required arguments
93
- if (!projectId) {
94
- console.error("Error: Missing required argument <project-id>");
95
- printHelp();
96
- return 1;
97
- }
98
- try {
99
- // Add confirmation prompt unless --force is used
100
- if (!force) {
101
- // Note: In a real implementation, we would use a proper prompt library
102
- // For now, we'll proceed without confirmation to keep it simple
103
- console.log(`🚨 Warning: This will permanently delete project ${projectId} and all related data.`);
104
- console.log(`📝 Related entities that will be deleted: git repositories, specifications, tasks, decisions, runs, verifications, notes, worktrees, merge requests`);
105
- console.log(`🔥 This action cannot be undone.`);
106
- // TODO: Add proper interactive confirmation
107
- // const confirmed = await confirm("Are you sure you want to continue? (y/N)");
108
- // if (!confirmed) {
109
- // console.log("💡 Deletion cancelled.");
110
- // return 0;
111
- // }
112
- }
113
- await deleteProject(projectId, apiUrl);
114
- return 0;
115
- }
116
- catch (error) {
117
- console.error("Error:", error instanceof Error ? error.message : String(error));
118
- return 1;
119
- }
120
- }
121
- if (require.main === module) {
122
- runProjectDeleteCli(process.argv.slice(2)).catch((err) => {
123
- console.error(err);
124
- process.exit(1);
125
- });
126
- }
@@ -1,99 +0,0 @@
1
- export interface ProjectContextData {
2
- projectId?: string;
3
- organizationId?: string;
4
- updatedAt?: string;
5
- }
6
- /** Enhanced global context with multi-project support */
7
- export interface GlobalContextData {
8
- /** Default organization for new projects */
9
- defaultOrganizationId?: string;
10
- /** List of projects the user has worked with */
11
- projects?: Array<{
12
- id: string;
13
- name?: string;
14
- organizationId: string;
15
- lastUsed: string;
16
- repoPaths: string[];
17
- repoSync?: {
18
- checkpoints?: Record<string, {
19
- lastHeadCommit?: string;
20
- syncedAt?: string;
21
- }>;
22
- };
23
- }>;
24
- /** Last used project ID for smart defaults */
25
- lastUsedProjectId?: string;
26
- /** User preferences */
27
- preferences?: {
28
- defaultAgent?: string;
29
- defaultFormat?: string;
30
- };
31
- /** When the global context was last updated */
32
- updatedAt?: string;
33
- /** Repo sync metadata keyed by absolute repo path */
34
- repoSync?: {
35
- checkpoints?: Record<string, {
36
- lastHeadCommit?: string;
37
- syncedAt?: string;
38
- }>;
39
- };
40
- }
41
- export interface ResolvedProjectContext {
42
- projectId: string;
43
- organizationId: string;
44
- }
45
- export declare function findNearestLocalContextFile(startDir?: string): string | null;
46
- export declare function loadLocalContext(repoPath?: string): ProjectContextData | null;
47
- export declare function loadGlobalContext(): GlobalContextData | null;
48
- export declare function resolveProjectContext(input: {
49
- explicitProjectId?: string;
50
- explicitOrganizationId?: string;
51
- repoPath?: string;
52
- credentialsOrganizationId?: string;
53
- envOrganizationId?: string;
54
- }): ResolvedProjectContext;
55
- /** Get the most recently used project from global context */
56
- export declare function getLastUsedProject(): {
57
- projectId: string;
58
- organizationId: string;
59
- } | null;
60
- /** List all recent projects from global context */
61
- export declare function listRecentProjects(): Array<{
62
- id: string;
63
- name?: string;
64
- organizationId: string;
65
- lastUsed: string;
66
- repoPaths: string[];
67
- }>;
68
- /** Set the last used project in global context */
69
- export declare function setLastUsedProject(projectId: string): void;
70
- /** Get project by ID from global context */
71
- export declare function getProjectFromGlobalContext(projectId: string): {
72
- id: string;
73
- name?: string;
74
- organizationId: string;
75
- lastUsed: string;
76
- repoPaths: string[];
77
- } | null;
78
- export declare function saveLocalContext(repoPath: string, context: {
79
- projectId: string;
80
- organizationId?: string;
81
- }): void;
82
- export declare function saveGlobalContext(context: GlobalContextData): void;
83
- /** Add or update a project in the global context history */
84
- export declare function addProjectToGlobalContext(projectId: string, organizationId: string, repoPath: string): void;
85
- export declare function ensureGitignoreHasSpekn(repoPath: string): void;
86
- export declare function persistProjectContext(repoPath: string, context: {
87
- projectId: string;
88
- organizationId?: string;
89
- }): void;
90
- export declare function persistProjectContextWithoutRepoPath(repoPath: string, context: {
91
- projectId: string;
92
- organizationId?: string;
93
- }): void;
94
- export declare function clearRepoFromGlobalContext(repoPath: string, projectId?: string): {
95
- removedProjectRefs: number;
96
- removedSyncCheckpoints: number;
97
- removedProjects: number;
98
- clearedLastUsedProjectId: boolean;
99
- };