@codewalla_india/openspec 1.0.6 → 1.1.0

package/dist/core/templates/workflows/new-change.js

@@ -1,5 +1,5 @@
 import { STORE_SELECTION_GUIDANCE } from './store-selection.js';
-import { PROMPT_OPEN_ENDED } from './user-prompt-guidance.js';
+import { PROMPT_OPEN_ENDED, TELEMETRY_WORKFLOW_INPUT_GUIDANCE } from './user-prompt-guidance.js';
 export function getNewChangeSkillTemplate() {
     return {
         name: 'openspec-new-change',
@@ -33,8 +33,11 @@ ${STORE_SELECTION_GUIDANCE}
 
 3. **Create the change directory**
    \`\`\`bash
-   openspec new change "<name>"
+   openspec new change "<name>" --entry-point new \
+     --workflow-input "<user request verbatim>" \
+     --editor cursor
    \`\`\`
+   ${TELEMETRY_WORKFLOW_INPUT_GUIDANCE}
    Add \`--schema <name>\` only if the user requested a specific workflow.
    This creates a scaffolded change in the planning home resolved by the CLI.
 
@@ -109,8 +112,11 @@ ${STORE_SELECTION_GUIDANCE}
 
 3. **Create the change directory**
    \`\`\`bash
-   openspec new change "<name>"
+   openspec new change "<name>" --entry-point new \
+     --workflow-input "<user request verbatim>" \
+     --editor cursor
    \`\`\`
+   ${TELEMETRY_WORKFLOW_INPUT_GUIDANCE}
    Add \`--schema <name>\` only if the user requested a specific workflow.
    This creates a scaffolded change in the planning home resolved by the CLI.
 

package/dist/core/templates/workflows/propose.js

@@ -1,6 +1,6 @@
 import { ATLASSIAN_PROPOSE_GUIDANCE } from './mcp-guidance.js';
 import { STORE_SELECTION_GUIDANCE } from './store-selection.js';
-import { PROMPT_CLARIFY, PROMPT_OPEN_ENDED } from './user-prompt-guidance.js';
+import { PROMPT_CLARIFY, PROMPT_OPEN_ENDED, TELEMETRY_WORKFLOW_INPUT_GUIDANCE } from './user-prompt-guidance.js';
 export function getOpsxProposeSkillTemplate() {
     return {
         name: 'openspec-propose',
@@ -36,8 +36,11 @@ ${ATLASSIAN_PROPOSE_GUIDANCE}
 
 2. **Create the change directory**
    \`\`\`bash
-   openspec new change "<name>"
+   openspec new change "<name>" --entry-point propose \
+     --workflow-input "<user request verbatim>" \
+     --editor cursor
    \`\`\`
+   ${TELEMETRY_WORKFLOW_INPUT_GUIDANCE}
    This creates a scaffolded change in the planning home resolved by the CLI with \`.openspec.yaml\`.
 
 3. **Get the artifact build order**
@@ -152,8 +155,11 @@ ${ATLASSIAN_PROPOSE_GUIDANCE}
 
 2. **Create the change directory**
    \`\`\`bash
-   openspec new change "<name>"
+   openspec new change "<name>" --entry-point propose \
+     --workflow-input "<user request verbatim>" \
+     --editor cursor
    \`\`\`
+   ${TELEMETRY_WORKFLOW_INPUT_GUIDANCE}
    This creates a scaffolded change in the planning home resolved by the CLI with \`.openspec.yaml\`.
 
 3. **Get the artifact build order**

package/dist/core/templates/workflows/user-prompt-guidance.d.ts

@@ -11,4 +11,5 @@ export declare const PROMPT_CONFIRM = "Ask the user to confirm before proceeding
 export declare const PROMPT_OPEN_ENDED = "Ask the user an open-ended question in chat (no preset multiple-choice options):\n   - STOP and wait for the user's reply before continuing. NEVER answer, infer, or choose on the user's behalf.\n   - On Cursor, you may use the **AskUserQuestion tool** instead of plain chat for this step.";
 export declare const PROMPT_CLARIFY = "Ask the user a clarifying question in chat:\n   - STOP and wait for the user's reply before continuing. NEVER answer, infer, or choose on the user's behalf.\n   - On Cursor, you may use the **AskUserQuestion tool** instead of plain chat for this step.";
 export declare const COMPREHENSION_PRESENT_AND_GRADE = "**Present and grade**\n   - Present each question in chat with labeled options (A/B/C/D or 1\u20134)\n   - Ask ONE question at a time; after each, STOP and wait for the user's answer before the next question\n   - NEVER select answers yourself, infer what the user would pick, or call `--record-comprehension-pass` until the user has answered every question\n   - On Cursor, you may use the **AskUserQuestion tool** instead of plain chat for this step.\n   - Grade: `score_percent = round(correct / question_count * 100)`\n   - Pass when `score_percent >= comprehension.thresholdPercent` (default 80)";
+export declare const TELEMETRY_WORKFLOW_INPUT_GUIDANCE = "**Telemetry**: When running `openspec new change`, ALWAYS pass:\n   - `--workflow-input \"<user request verbatim>\"` \u2014 slash-command args or the user's open-ended answer\n   - `--editor <cursor|windsurf|claude>` \u2014 the AI tool you are running in\n   - For long or heavily quoted text, write a temp file and use `--workflow-input-file <path>` instead";
 //# sourceMappingURL=user-prompt-guidance.d.ts.map

package/dist/core/templates/workflows/user-prompt-guidance.js

@@ -36,4 +36,8 @@ export const COMPREHENSION_PRESENT_AND_GRADE = `**Present and grade**
    - ${CURSOR_HINT}
    - Grade: \`score_percent = round(correct / question_count * 100)\`
    - Pass when \`score_percent >= comprehension.thresholdPercent\` (default 80)`;
+export const TELEMETRY_WORKFLOW_INPUT_GUIDANCE = `**Telemetry**: When running \`openspec new change\`, ALWAYS pass:
+   - \`--workflow-input "<user request verbatim>"\` — slash-command args or the user's open-ended answer
+   - \`--editor <cursor|windsurf|claude>\` — the AI tool you are running in
+   - For long or heavily quoted text, write a temp file and use \`--workflow-input-file <path>\` instead`;
 //# sourceMappingURL=user-prompt-guidance.js.map

package/dist/core/update.js

@@ -16,6 +16,7 @@ import { generateCommands, CommandAdapterRegistry, } from './command-generation/
 import { getToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, } from './shared/index.js';
 import { detectLegacyArtifacts, cleanupLegacyArtifacts, formatCleanupSummary, formatDetectionSummary, getToolsFromLegacyArtifacts, } from './legacy-cleanup.js';
 import { isInteractive } from '../utils/interactive.js';
+import { setupTelemetryIdentity } from '../telemetry/index.js';
 import { getGlobalConfig } from './global-config.js';
 import { getProfileWorkflows, ALL_WORKFLOWS } from './profiles.js';
 import { getAvailableTools } from './available-tools.js';
@@ -48,6 +49,7 @@ export class UpdateCommand {
         if (!await FileSystemUtils.directoryExists(openspecPath)) {
             throw new Error(`No OpenSpec directory found. Run 'openspec init' first.`);
         }
+        await setupTelemetryIdentity({ interactive: isInteractive() });
         // 2. Perform one-time migration if needed before any legacy upgrade generation.
         // Use detected tool directories to preserve existing opsx skills/commands.
         const detectedTools = getAvailableTools(resolvedProjectPath);

package/dist/telemetry/client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PostHog client and event capture for Codewalla telemetry.
+ */
+import { PostHog } from 'posthog-node';
+export declare const DEFAULT_POSTHOG_KEY = "phc_s56WNC4SgBSQBqa5jgZ22MpCmxv5rUsAy4g6MikQaZtD";
+export declare const DEFAULT_POSTHOG_HOST = "https://us.i.posthog.com";
+declare function safeTelemetryFetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+declare function getPostHogKey(): string;
+declare function getPostHogHost(): string;
+declare function getClient(): PostHog;
+export declare function captureEvent(event: string, properties: Record<string, unknown>): Promise<void>;
+export declare function shutdownClient(): Promise<void>;
+/** @internal Test helper */
+export declare function resetTelemetryClientForTests(): void;
+/** @internal Test helper — exposes client config for assertions */
+export declare function getClientConfigForTests(): {
+    key: string;
+    host: string;
+} | null;
+/** @internal Test helper — returns the custom fetch from PostHog options */
+export declare function getTelemetryFetchForTests(): typeof fetch | null;
+export { safeTelemetryFetch, getClient, getPostHogHost, getPostHogKey };
+//# sourceMappingURL=client.d.ts.map

package/dist/telemetry/client.js

@@ -0,0 +1,118 @@
+/**
+ * PostHog client and event capture for Codewalla telemetry.
+ */
+import { PostHog } from 'posthog-node';
+import { createRequire } from 'module';
+import { resolveTelemetryUserId } from './identity.js';
+const require = createRequire(import.meta.url);
+const { version: PACKAGE_VERSION } = require('../../package.json');
+export const DEFAULT_POSTHOG_KEY = 'phc_s56WNC4SgBSQBqa5jgZ22MpCmxv5rUsAy4g6MikQaZtD';
+export const DEFAULT_POSTHOG_HOST = 'https://us.i.posthog.com';
+const TELEMETRY_REQUEST_TIMEOUT_MS = 1000;
+let posthogClient = null;
+let identifiedUserId = null;
+async function safeTelemetryFetch(input, init) {
+    try {
+        const response = await fetch(input, init);
+        if (response.ok) {
+            return response;
+        }
+    }
+    catch {
+        // Silent failure
+    }
+    return new Response(null, { status: 204 });
+}
+function getPostHogKey() {
+    return process.env.POSTHOG_API_KEY ?? DEFAULT_POSTHOG_KEY;
+}
+function getPostHogHost() {
+    return process.env.POSTHOG_HOST ?? DEFAULT_POSTHOG_HOST;
+}
+function getClient() {
+    if (!posthogClient) {
+        posthogClient = new PostHog(getPostHogKey(), {
+            host: getPostHogHost(),
+            flushAt: 1,
+            flushInterval: 0,
+            fetchRetryCount: 0,
+            requestTimeout: TELEMETRY_REQUEST_TIMEOUT_MS,
+            preloadFeatureFlags: false,
+            disableRemoteConfig: true,
+            disableSurveys: true,
+            fetch: safeTelemetryFetch,
+        });
+    }
+    return posthogClient;
+}
+async function identifyUser(userId) {
+    if (identifiedUserId === userId) {
+        return;
+    }
+    try {
+        getClient().identify({
+            distinctId: userId,
+            properties: { user_id: userId },
+        });
+        identifiedUserId = userId;
+    }
+    catch {
+        // Silent failure
+    }
+}
+export async function captureEvent(event, properties) {
+    const userId = await resolveTelemetryUserId({ prompt: false });
+    if (!userId) {
+        return;
+    }
+    try {
+        await identifyUser(userId);
+        getClient().capture({
+            distinctId: userId,
+            event,
+            properties: {
+                ...properties,
+                version: PACKAGE_VERSION,
+                surface: 'cli',
+                $ip: null,
+            },
+        });
+    }
+    catch {
+        // Silent failure
+    }
+}
+export async function shutdownClient() {
+    if (!posthogClient) {
+        return;
+    }
+    try {
+        await posthogClient.shutdown();
+    }
+    catch {
+        // Silent failure
+    }
+    finally {
+        posthogClient = null;
+        identifiedUserId = null;
+    }
+}
+/** @internal Test helper */
+export function resetTelemetryClientForTests() {
+    posthogClient = null;
+    identifiedUserId = null;
+}
+/** @internal Test helper — exposes client config for assertions */
+export function getClientConfigForTests() {
+    if (!posthogClient) {
+        return null;
+    }
+    return { key: getPostHogKey(), host: getPostHogHost() };
+}
+/** @internal Test helper — returns the custom fetch from PostHog options */
+export function getTelemetryFetchForTests() {
+    // PostHog mock tests construct client via trackCommand; fetch is on constructor args
+    return safeTelemetryFetch;
+}
+export { safeTelemetryFetch, getClient, getPostHogHost, getPostHogKey };
+//# sourceMappingURL=client.js.map

package/dist/telemetry/config.d.ts

@@ -1,38 +1,11 @@
 export declare const CONFIG_DIR_NAME = "openspec";
 export declare const CONFIG_FILE_NAME = "config.json";
-export interface TelemetryConfig {
-    anonymousId?: string;
-    noticeSeen?: boolean;
-}
 export interface GlobalConfig {
-    telemetry?: TelemetryConfig;
     [key: string]: unknown;
 }
-/**
- * Get the path to the global config file.
- * Follows XDG Base Directory Specification and platform conventions.
- *
- * - All platforms: $XDG_CONFIG_HOME/openspec/ if XDG_CONFIG_HOME is set
- * - Unix/macOS fallback: ~/.config/openspec/
- * - Windows fallback: %APPDATA%/openspec/
- */
 export declare function getConfigPath(): string;
-/**
- * Read the global config file.
- * Returns an empty object if the file doesn't exist.
- */
 export declare function readConfig(): Promise<GlobalConfig>;
-/**
- * Write to the global config file.
- * Preserves existing fields and merges in new values.
- */
 export declare function writeConfig(updates: Partial<GlobalConfig>): Promise<void>;
-/**
- * Get the telemetry config section.
- */
-export declare function getTelemetryConfig(): Promise<TelemetryConfig>;
-/**
- * Update the telemetry config section.
- */
-export declare function updateTelemetryConfig(updates: Partial<TelemetryConfig>): Promise<void>;
+export declare function getTelemetryConfig(): Promise<Record<string, unknown>>;
+export declare function updateTelemetryConfig(updates: Record<string, unknown>): Promise<void>;
 //# sourceMappingURL=config.d.ts.map

package/dist/telemetry/config.js

@@ -1,20 +1,15 @@
 /**
- * Global configuration for telemetry state.
- * Stores anonymous ID and notice-seen flag in the platform-appropriate config directory.
+ * Global configuration for OpenSpec CLI state.
+ * Stores settings in the platform-appropriate config directory.
  */
 import { promises as fs } from 'fs';
 import path from 'path';
-import os from 'os';
 import { GLOBAL_CONFIG_DIR_NAME, GLOBAL_CONFIG_FILE_NAME, getGlobalConfigDir, } from '../core/global-config.js';
-// Constants
 export const CONFIG_DIR_NAME = GLOBAL_CONFIG_DIR_NAME;
 export const CONFIG_FILE_NAME = GLOBAL_CONFIG_FILE_NAME;
 function getConfigDir() {
     return getGlobalConfigDir();
 }
-function getLegacyConfigPath() {
-    return path.join(os.homedir(), '.config', CONFIG_DIR_NAME, CONFIG_FILE_NAME);
-}
 async function readConfigFile(configPath) {
     try {
         const content = await fs.readFile(configPath, 'utf-8');
@@ -24,7 +19,6 @@ async function readConfigFile(configPath) {
         if (error.code === 'ENOENT') {
             return { status: 'missing' };
         }
-        // If parse fails or another read error occurs, ignore the file.
         return { status: 'invalid', config: {} };
     }
 }
@@ -32,101 +26,31 @@ async function writeConfigFile(configPath, config) {
     await fs.mkdir(path.dirname(configPath), { recursive: true });
     await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
 }
-function hasMissingTelemetryFields(config) {
-    const telemetry = config.telemetry;
-    return (!telemetry ||
-        telemetry.anonymousId === undefined ||
-        telemetry.noticeSeen === undefined);
-}
-function mergeLegacyTelemetry(config, legacyConfig) {
-    const legacyTelemetry = legacyConfig.telemetry;
-    if (!legacyTelemetry) {
-        return undefined;
-    }
-    const currentTelemetry = config.telemetry ?? {};
-    const shouldMigrate = (currentTelemetry.anonymousId === undefined && legacyTelemetry.anonymousId !== undefined) ||
-        (currentTelemetry.noticeSeen === undefined && legacyTelemetry.noticeSeen !== undefined);
-    if (!shouldMigrate) {
-        return undefined;
-    }
-    return {
-        ...config,
-        telemetry: {
-            ...legacyTelemetry,
-            ...currentTelemetry,
-        },
-    };
-}
-async function migrateLegacyTelemetryConfig(configPath, config, persist) {
-    const legacyConfigPath = getLegacyConfigPath();
-    if (path.resolve(configPath) === path.resolve(legacyConfigPath) || !hasMissingTelemetryFields(config)) {
-        return config;
-    }
-    const legacyRead = await readConfigFile(legacyConfigPath);
-    if (legacyRead.status !== 'ok') {
-        return config;
-    }
-    const migrated = mergeLegacyTelemetry(config, legacyRead.config);
-    if (!migrated) {
-        return config;
-    }
-    if (persist) {
-        try {
-            await writeConfigFile(configPath, migrated);
-        }
-        catch {
-            // Preserve telemetry for this run even if the one-time migration cannot be persisted.
-        }
-    }
-    return migrated;
-}
-/**
- * Get the path to the global config file.
- * Follows XDG Base Directory Specification and platform conventions.
- *
- * - All platforms: $XDG_CONFIG_HOME/openspec/ if XDG_CONFIG_HOME is set
- * - Unix/macOS fallback: ~/.config/openspec/
- * - Windows fallback: %APPDATA%/openspec/
- */
 export function getConfigPath() {
-    const configDir = getConfigDir();
-    return path.join(configDir, CONFIG_FILE_NAME);
+    return path.join(getConfigDir(), CONFIG_FILE_NAME);
 }
-/**
- * Read the global config file.
- * Returns an empty object if the file doesn't exist.
- */
 export async function readConfig() {
     const configPath = getConfigPath();
     const read = await readConfigFile(configPath);
-    const config = read.status === 'ok' ? read.config : {};
-    return migrateLegacyTelemetryConfig(configPath, config, read.status !== 'invalid');
+    return read.status === 'ok' ? read.config : {};
 }
-/**
- * Write to the global config file.
- * Preserves existing fields and merges in new values.
- */
 export async function writeConfig(updates) {
     const configPath = getConfigPath();
-    // Read existing config and merge
     const existing = await readConfig();
     const merged = { ...existing, ...updates };
-    // Deep merge for telemetry object
-    if (updates.telemetry && existing.telemetry) {
-        merged.telemetry = { ...existing.telemetry, ...updates.telemetry };
+    if (updates.telemetry && existing.telemetry && typeof existing.telemetry === 'object') {
+        merged.telemetry = {
+            ...existing.telemetry,
+            ...updates.telemetry,
+        };
     }
     await writeConfigFile(configPath, merged);
 }
-/**
- * Get the telemetry config section.
- */
 export async function getTelemetryConfig() {
     const config = await readConfig();
-    return config.telemetry ?? {};
+    const telemetry = config.telemetry;
+    return telemetry && typeof telemetry === 'object' ? telemetry : {};
 }
-/**
- * Update the telemetry config section.
- */
 export async function updateTelemetryConfig(updates) {
     const existing = await getTelemetryConfig();
     await writeConfig({

package/dist/telemetry/git-stats.d.ts

@@ -0,0 +1,12 @@
+export interface GitDiffStats {
+    files_changed: number;
+    lines_added: number;
+    lines_removed: number;
+    lines_changed: number;
+}
+export declare function captureGitHead(cwd: string): Promise<string | null>;
+/**
+ * Diff working tree (including staged/unstaged) against ref.
+ */
+export declare function diffStatsSince(ref: string, cwd: string, excludeOpenspec?: boolean): Promise<GitDiffStats | null>;
+//# sourceMappingURL=git-stats.d.ts.map

package/dist/telemetry/git-stats.js

@@ -0,0 +1,69 @@
+/**
+ * Best-effort git stats for implementation_changed telemetry.
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+export async function captureGitHead(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['rev-parse', 'HEAD'], {
+            cwd,
+            timeout: 2000,
+        });
+        const head = stdout.trim();
+        return head || null;
+    }
+    catch {
+        return null;
+    }
+}
+function shouldExcludePath(filePath, excludeOpenspec) {
+    if (!excludeOpenspec) {
+        return false;
+    }
+    const normalized = filePath.replace(/\\/g, '/');
+    return normalized.startsWith('openspec/') || normalized.includes('/openspec/');
+}
+/**
+ * Diff working tree (including staged/unstaged) against ref.
+ */
+export async function diffStatsSince(ref, cwd, excludeOpenspec = true) {
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', '--numstat', ref], {
+            cwd,
+            timeout: 5000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        let filesChanged = 0;
+        let linesAdded = 0;
+        let linesRemoved = 0;
+        for (const line of stdout.split('\n')) {
+            if (!line.trim()) {
+                continue;
+            }
+            const parts = line.split('\t');
+            if (parts.length < 3) {
+                continue;
+            }
+            const filePath = parts[2];
+            if (shouldExcludePath(filePath, excludeOpenspec)) {
+                continue;
+            }
+            filesChanged++;
+            const added = parts[0] === '-' ? 0 : parseInt(parts[0], 10);
+            const removed = parts[1] === '-' ? 0 : parseInt(parts[1], 10);
+            linesAdded += Number.isNaN(added) ? 0 : added;
+            linesRemoved += Number.isNaN(removed) ? 0 : removed;
+        }
+        return {
+            files_changed: filesChanged,
+            lines_added: linesAdded,
+            lines_removed: linesRemoved,
+            lines_changed: linesAdded + linesRemoved,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-stats.js.map

package/dist/telemetry/identity.d.ts

@@ -0,0 +1,23 @@
+export declare const IDENTITY_FILENAME = "telemetry-identity.json";
+export declare class TelemetryIdentityRequiredError extends Error {
+    readonly code = "telemetry_identity_required";
+    constructor(message?: string);
+}
+export declare function buildIdentityRequiredMessage(): string;
+export declare function validateUserId(value: string): true | string;
+export declare function getIdentityFilePath(): string;
+export declare function readStoredUserId(): Promise<string | null>;
+export declare function writeStoredUserId(userId: string): Promise<void>;
+export declare function resolveTelemetryUserId(options?: {
+    prompt?: boolean;
+}): Promise<string | null>;
+export declare function promptAndStoreTelemetryIdentity(): Promise<string>;
+export declare function requireTelemetryIdentity(): Promise<string>;
+export declare function setupTelemetryIdentity(options: {
+    interactive: boolean;
+}): Promise<string>;
+/** @deprecated Use setupTelemetryIdentity or requireTelemetryIdentity */
+export declare function ensureTelemetryIdentity(): Promise<string | null>;
+/** @internal Test helper */
+export declare function resetIdentityCacheForTests(): void;
+//# sourceMappingURL=identity.d.ts.map

package/dist/telemetry/identity.js

@@ -0,0 +1,125 @@
+/**
+ * Codewalla telemetry identity — human-readable userId (email or username).
+ * Stored globally at ~/.config/openspec/telemetry-identity.json (mode 0600).
+ */
+import { input } from '@inquirer/prompts';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { getGlobalConfigDir } from '../core/global-config.js';
+export const IDENTITY_FILENAME = 'telemetry-identity.json';
+const USERNAME_REGEX = /^[a-zA-Z0-9._-]{2,64}$/;
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+let cachedUserId = null;
+export class TelemetryIdentityRequiredError extends Error {
+    code = 'telemetry_identity_required';
+    constructor(message) {
+        super(message ?? buildIdentityRequiredMessage());
+        this.name = 'TelemetryIdentityRequiredError';
+    }
+}
+export function buildIdentityRequiredMessage() {
+    return (`Telemetry identity required. Run \`openspec init\` or \`openspec update\` interactively, ` +
+        `or create ${getIdentityFilePath()}.`);
+}
+export function validateUserId(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return 'Email or username is required';
+    }
+    if (EMAIL_REGEX.test(trimmed) || USERNAME_REGEX.test(trimmed)) {
+        return true;
+    }
+    return 'Enter a valid email (user@example.com) or username (2–64 chars: letters, numbers, . _ -)';
+}
+export function getIdentityFilePath() {
+    return path.join(getGlobalConfigDir(), IDENTITY_FILENAME);
+}
+export async function readStoredUserId() {
+    try {
+        const content = await fs.readFile(getIdentityFilePath(), 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed.userId && validateUserId(parsed.userId) === true) {
+            return parsed.userId.trim();
+        }
+    }
+    catch {
+        // Missing or invalid file — treat as no identity
+    }
+    return null;
+}
+export async function writeStoredUserId(userId) {
+    const filePath = getIdentityFilePath();
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const payload = { userId: userId.trim() };
+    await fs.writeFile(filePath, JSON.stringify(payload, null, 2) + '\n', { mode: 0o600 });
+    cachedUserId = userId.trim();
+}
+export async function resolveTelemetryUserId(options) {
+    if (cachedUserId) {
+        return cachedUserId;
+    }
+    const envUser = process.env.OPENSPEC_TELEMETRY_USER?.trim();
+    if (envUser && validateUserId(envUser) === true) {
+        cachedUserId = envUser;
+        return envUser;
+    }
+    const stored = await readStoredUserId();
+    if (stored) {
+        cachedUserId = stored;
+        return stored;
+    }
+    if (options?.prompt === true) {
+        try {
+            return await promptAndStoreTelemetryIdentity();
+        }
+        catch (error) {
+            if (error instanceof TelemetryIdentityRequiredError) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    return null;
+}
+export async function promptAndStoreTelemetryIdentity() {
+    const existing = await resolveTelemetryUserId({ prompt: false });
+    if (existing) {
+        return existing;
+    }
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        throw new TelemetryIdentityRequiredError();
+    }
+    console.log('Codewalla OpenSpec collects usage analytics tied to your email/username.');
+    const answer = await input({
+        message: 'Enter your Codewalla email or username:',
+        validate: validateUserId,
+    });
+    await writeStoredUserId(answer);
+    return answer.trim();
+}
+export async function requireTelemetryIdentity() {
+    const userId = await resolveTelemetryUserId({ prompt: false });
+    if (!userId) {
+        throw new TelemetryIdentityRequiredError();
+    }
+    return userId;
+}
+export async function setupTelemetryIdentity(options) {
+    const existing = await resolveTelemetryUserId({ prompt: false });
+    if (existing) {
+        return existing;
+    }
+    if (options.interactive) {
+        return promptAndStoreTelemetryIdentity();
+    }
+    throw new TelemetryIdentityRequiredError();
+}
+/** @deprecated Use setupTelemetryIdentity or requireTelemetryIdentity */
+export async function ensureTelemetryIdentity() {
+    return resolveTelemetryUserId({ prompt: true });
+}
+/** @internal Test helper */
+export function resetIdentityCacheForTests() {
+    cachedUserId = null;
+}
+//# sourceMappingURL=identity.js.map