@devcortex/cli 1.3.0

package/dist/commands/update.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+export interface UpdateOptions {
+    agent?: string;
+    apiUrl?: string;
+    watch?: boolean;
+}
+export declare function runUpdate(opts: UpdateOptions, cwd?: string): Promise<string>;
+export declare function registerUpdate(program: Command): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAWD,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDzF;AAgFD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAerD"}

package/dist/commands/update.js

@@ -0,0 +1,124 @@
+import * as clack from '@clack/prompts';
+import { writeFileSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readLinkFile, detectStack, substituteStackCommands } from './init.js';
+import { apiJson } from '../lib/api.js';
+export async function runUpdate(opts, cwd = process.cwd()) {
+    // AC-5: Check link file
+    const link = readLinkFile(cwd);
+    if (!link) {
+        console.error('✗ No project linked. Run dcx init first.');
+        process.exit(1);
+    }
+    const agentFile = opts.agent === 'opencode' ? 'AGENTS.md' : 'CLAUDE.md';
+    const filePath = join(cwd, agentFile);
+    // Read old content for diff
+    const oldContent = existsSync(filePath) ? readFileSync(filePath, 'utf8') : '';
+    // AC-1: Fetch constitution
+    const res = await apiJson(`/organisations/${link.orgSlug}/projects/${link.projectId}/constitution`, {}, opts.apiUrl ?? link.apiUrl);
+    const stack = detectStack(cwd);
+    const newContent = substituteStackCommands(res.content, stack);
+    // AC-4: No changes
+    if (newContent === oldContent) {
+        clack.note(`${agentFile} is already up to date`);
+        return newContent;
+    }
+    // AC-1: Overwrite file
+    writeFileSync(filePath, newContent);
+    // AC-2: Diff summary (count requirement lines)
+    const oldReqs = countReqLines(oldContent);
+    const newReqs = countReqLines(newContent);
+    const oldIssues = countIssueLines(oldContent);
+    const newIssues = countIssueLines(newContent);
+    const diff = [];
+    if (newReqs > oldReqs)
+        diff.push(`+ ${newReqs - oldReqs} requirements added`);
+    if (newReqs < oldReqs)
+        diff.push(`- ${oldReqs - newReqs} requirements removed`);
+    if (newIssues !== oldIssues)
+        diff.push(`~ issues: ${oldIssues} → ${newIssues}`);
+    clack.note([
+        `✔ ${agentFile} refreshed`,
+        ...diff,
+        `→ ${agentFile} is up to date (${newReqs} requirements, ${newIssues} issues)`,
+    ].join('\n'));
+    return newContent;
+}
+async function watchUpdate(opts, cwd = process.cwd()) {
+    const link = readLinkFile(cwd);
+    if (!link) {
+        console.error('✗ No project linked. Run dcx init first.');
+        process.exit(1);
+    }
+    const agentFile = opts.agent === 'opencode' ? 'AGENTS.md' : 'CLAUDE.md';
+    const apiUrlOverride = opts.apiUrl ?? link.apiUrl;
+    // Step 1: Full update immediately
+    console.log('DevCortex Watch — running initial update...');
+    await runUpdate(opts, cwd);
+    let lastPoll = new Date().toISOString();
+    console.log(`Watching for requirement changes every 60s. Press Ctrl+C to stop.\n`);
+    // Handle Ctrl+C gracefully
+    process.on('SIGINT', () => {
+        console.log('\nStopped watching');
+        process.exit(0);
+    });
+    // Poll every 60 seconds
+    const poll = setInterval(async () => {
+        try {
+            const res = await apiJson(`/organisations/${link.orgSlug}/projects/${link.projectId}/requirements?since=${encodeURIComponent(lastPoll)}`, {}, apiUrlOverride);
+            const changedCount = res.total ?? res.data?.length ?? 0;
+            const pollTime = new Date().toISOString();
+            if (changedCount > 0) {
+                // Regenerate the constitution file
+                try {
+                    const constitution = await apiJson(`/organisations/${link.orgSlug}/projects/${link.projectId}/constitution`, {}, apiUrlOverride);
+                    const filePath = join(cwd, agentFile);
+                    const stack = detectStack(cwd);
+                    writeFileSync(filePath, substituteStackCommands(constitution.content, stack));
+                    console.log(`✔ ${agentFile} updated — ${changedCount} requirement(s) changed`);
+                }
+                catch {
+                    console.error(`✗ Failed to regenerate ${agentFile}`);
+                }
+            }
+            lastPoll = pollTime;
+        }
+        catch {
+            // Silently continue on poll failure
+        }
+    }, 60000);
+    // Keep process alive
+    await new Promise(() => {
+        // This promise never resolves — the process stays alive until SIGINT
+        // clearInterval cleanup happens in the SIGINT handler above
+        process.on('SIGTERM', () => {
+            clearInterval(poll);
+            console.log('\nStopped watching');
+            process.exit(0);
+        });
+    });
+}
+function countReqLines(content) {
+    return (content.match(/^- REQ-/gm) ?? []).length;
+}
+function countIssueLines(content) {
+    return (content.match(/^- ISS-/gm) ?? []).length;
+}
+export function registerUpdate(program) {
+    program
+        .command('update')
+        .description('Refresh CLAUDE.md from the live database')
+        .option('--agent <name>', 'Agent type: claude (default) | opencode')
+        .option('--api-url <url>', 'API URL override')
+        .option('--watch', 'Watch for requirement changes and auto-update CLAUDE.md every 60s')
+        .action(async (opts) => {
+        if (opts.watch) {
+            await watchUpdate(opts);
+        }
+        else {
+            clack.intro('DevCortex Update');
+            await runUpdate(opts);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+export declare const program: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// REQ-059: DevCortex CLI Foundation — @devcortex/cli
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { registerLogin } from './commands/login.js';
+import { registerInit } from './commands/init.js';
+import { registerStart } from './commands/start.js';
+import { registerKeys } from './commands/keys.js';
+import { registerStatus } from './commands/status.js';
+import { registerLogs } from './commands/logs.js';
+import { registerUpdate } from './commands/update.js';
+import { registerList } from './commands/list.js';
+import { registerExport } from './commands/export.js';
+import { registerImport } from './commands/import.js';
+import { registerTestMcp } from './commands/test-mcp.js';
+import { registerIssue } from './commands/issue.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export const program = new Command();
+program
+    .name('dcx')
+    .description('DevCortex CLI — connect AI agents to your project')
+    .version(pkg.version) // AC-3: --version outputs version
+    // AC-6: --api-url global flag
+    .option('--api-url <url>', 'Override API URL (default: http://localhost:3001)');
+// AC-4: Register all commands
+registerLogin(program);
+registerInit(program);
+registerStart(program);
+registerKeys(program);
+registerStatus(program);
+registerLogs(program);
+registerUpdate(program);
+registerList(program);
+registerExport(program);
+registerImport(program);
+registerTestMcp(program);
+registerIssue(program);
+// AC-7: Only parse argv when run directly (not when imported by tests)
+import { fileURLToPath } from 'node:url';
+const isMain = fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain) {
+    program.parseAsync(process.argv).catch((err) => {
+        console.error(`✗ ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qDAAqD;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAE,kCAAkC;IACzD,8BAA8B;KAC7B,MAAM,CAAC,iBAAiB,EAAE,mDAAmD,CAAC,CAAC;AAElF,8BAA8B;AAC9B,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,aAAa,CAAC,OAAO,CAAC,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClE,IAAI,MAAM,EAAE,CAAC;IACX,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtD,OAAO,CAAC,KAAK,CAAC,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/api.d.ts

@@ -0,0 +1,8 @@
+export interface ApiError {
+    status: number;
+    message: string;
+}
+export declare function apiRequest(path: string, options?: RequestInit, apiUrlOverride?: string): Promise<Response>;
+export declare function apiJson<T>(path: string, options?: RequestInit, apiUrlOverride?: string): Promise<T>;
+export declare function isApiReachable(apiUrl?: string): Promise<boolean>;
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED,wBAAsB,OAAO,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIhE"}

package/dist/lib/api.js

@@ -0,0 +1,30 @@
+// API client — wraps fetch with auth header and base URL.
+import { getApiUrl, getToken } from './config.js';
+export async function apiRequest(path, options = {}, apiUrlOverride) {
+    const base = getApiUrl(apiUrlOverride);
+    const token = getToken();
+    const headers = {
+        'Content-Type': 'application/json',
+        ...(options.headers ?? {}),
+    };
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
+    return fetch(`${base}${path}`, { ...options, headers });
+}
+export async function apiJson(path, options = {}, apiUrlOverride) {
+    const res = await apiRequest(path, options, apiUrlOverride);
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        const msg = body?.error?.message ?? body?.message ?? `HTTP ${res.status}`;
+        const err = new Error(msg);
+        err.status = res.status;
+        throw err;
+    }
+    return res.json();
+}
+export function isApiReachable(apiUrl) {
+    return fetch(`${getApiUrl(apiUrl)}/health`)
+        .then((r) => r.ok)
+        .catch(() => false);
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOlD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,UAAuB,EAAE,EACzB,cAAuB;IAEvB,MAAM,IAAI,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,GAAG,CAAC,OAAO,CAAC,OAAiC,IAAI,EAAE,CAAC;KACrD,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IACxD,OAAO,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAY,EACZ,UAAuB,EAAE,EACzB,cAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAuD,CAAC;QACtG,MAAM,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,GAAG,CAA+B,CAAC;QACzD,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACxB,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,OAAO,KAAK,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,20 @@
+export declare function requireAuth(): string;
+export interface LoginResponse {
+    token: string;
+    expiresIn?: number;
+    user: {
+        id: string;
+        name: string;
+        email: string;
+        orgMemberships?: Array<{
+            orgSlug: string;
+        }>;
+    };
+}
+export interface OrgProject {
+    id: string;
+    name: string;
+    orgSlug: string;
+}
+export declare function storeToken(loginData: LoginResponse): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAIzD"}

package/dist/lib/auth.js

@@ -0,0 +1,16 @@
+// Token management helpers.
+import { config, getToken, isTokenExpired } from './config.js';
+export function requireAuth() {
+    const token = getToken();
+    if (!token || isTokenExpired()) {
+        console.error('✗ Not logged in — run dcx login first');
+        process.exit(1);
+    }
+    return token;
+}
+export function storeToken(loginData) {
+    const expiry = new Date(Date.now() + (loginData.expiresIn ?? 86400) * 1000).toISOString();
+    config.set('token', loginData.token);
+    config.set('tokenExpiry', expiry);
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,cAAc,EAAE,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAmBD,MAAM,UAAU,UAAU,CAAC,SAAwB;IACjD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1F,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,16 @@
+import Conf from 'conf';
+export interface CliConfig {
+    apiUrl?: string;
+    token?: string;
+    tokenExpiry?: string;
+    defaultOrgSlug?: string;
+    defaultProjectId?: string;
+    watchEnabled?: boolean;
+}
+export declare const DEFAULT_API_URL = "https://api.devcortexai.com";
+export declare const config: Conf<CliConfig>;
+export declare function getApiUrl(override?: string): string;
+export declare function getToken(): string | undefined;
+export declare function isTokenExpired(): boolean;
+export declare function clearAuth(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAE7D,eAAO,MAAM,MAAM,iBAIjB,CAAC;AAEH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,QAAQ,IAAI,MAAM,GAAG,SAAS,CAE7C;AAED,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAKhC"}

package/dist/lib/config.js

@@ -0,0 +1,29 @@
+// REQ-059 AC-5: Config stored at ~/.devcortex/config.json via conf package.
+import Conf from 'conf';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const DEFAULT_API_URL = 'https://api.devcortexai.com';
+export const config = new Conf({
+    cwd: join(homedir(), '.devcortex'),
+    configName: 'config',
+    accessPropertiesByDotNotation: false,
+});
+export function getApiUrl(override) {
+    return override ?? config.get('apiUrl') ?? DEFAULT_API_URL;
+}
+export function getToken() {
+    return config.get('token');
+}
+export function isTokenExpired() {
+    const expiry = config.get('tokenExpiry');
+    if (!expiry)
+        return true;
+    return new Date(expiry) < new Date();
+}
+export function clearAuth() {
+    config.delete('token');
+    config.delete('tokenExpiry');
+    config.delete('defaultOrgSlug');
+    config.delete('defaultProjectId');
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,MAAM,CAAC,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAY;IACxC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC;IAClC,UAAU,EAAE,QAAQ;IACpB,6BAA6B,EAAE,KAAK;CACrC,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,QAAiB;IACzC,OAAO,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7B,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@devcortex/cli",
+  "version": "1.3.0",
+  "description": "DevCortex CLI — structured requirements for agentic development",
+  "type": "module",
+  "bin": {
+    "dcx": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.0.0",
+    "@clack/prompts": "^0.7.0",
+    "chalk": "^5.3.0",
+    "conf": "^12.0.0",
+    "socket.io-client": "^4.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/add-shebang.mjs && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  }
+}