@proletariat/cli 0.3.51 → 0.3.53

package/dist/lib/external-issues/jira.js

@@ -0,0 +1,224 @@
+import { ExternalIssueAdapterError, toNormalizedEnvelope, } from './types.js';
+import { JiraIssueAdapter } from './adapters.js';
+const DEFAULT_JIRA_API_PATH = '/rest/api/3';
+const JIRA_ISSUE_FIELDS = [
+    'summary',
+    'description',
+    'labels',
+    'priority',
+    'status',
+    'project',
+    'issuetype',
+    'assignee',
+];
+function normalizeBaseUrl(value) {
+    const trimmed = value.trim().replace(/\/+$/, '');
+    if (/^https?:\/\//i.test(trimmed)) {
+        return trimmed;
+    }
+    return `https://${trimmed}`;
+}
+function ensureJiraConfig(config) {
+    const baseUrl = config.baseUrl
+        || config.host
+        || process.env.PRLT_JIRA_BASE_URL
+        || process.env.JIRA_BASE_URL
+        || process.env.PRLT_JIRA_HOST
+        || process.env.JIRA_HOST;
+    const email = config.email || process.env.PRLT_JIRA_EMAIL || process.env.JIRA_EMAIL || '';
+    const apiToken = config.apiToken || process.env.PRLT_JIRA_API_TOKEN || process.env.JIRA_API_TOKEN;
+    const projectKey = config.projectKey || process.env.PRLT_JIRA_PROJECT || process.env.JIRA_PROJECT_KEY || '';
+    const jql = config.jql || process.env.PRLT_JIRA_JQL || '';
+    if (!baseUrl) {
+        throw new ExternalIssueAdapterError('MISSING_CONFIG', 'Missing Jira base URL. Set PRLT_JIRA_BASE_URL/JIRA_BASE_URL or PRLT_JIRA_HOST/JIRA_HOST.');
+    }
+    if (!apiToken) {
+        throw new ExternalIssueAdapterError('MISSING_CONFIG', 'Missing Jira API token. Set PRLT_JIRA_API_TOKEN or JIRA_API_TOKEN.');
+    }
+    return {
+        baseUrl: normalizeBaseUrl(baseUrl),
+        host: normalizeBaseUrl(baseUrl),
+        email,
+        apiToken,
+        projectKey,
+        jql,
+    };
+}
+function ensureIssueKey(key) {
+    const trimmed = key.trim().toUpperCase();
+    if (!/^[A-Z][A-Z0-9_]*-\d+$/.test(trimmed)) {
+        throw new ExternalIssueAdapterError('BAD_PAYLOAD', `Invalid Jira issue key: "${key}".`);
+    }
+    return trimmed;
+}
+function buildAuthHeader(config) {
+    if (config.email) {
+        const token = Buffer.from(`${config.email}:${config.apiToken}`).toString('base64');
+        return `Basic ${token}`;
+    }
+    return `Bearer ${config.apiToken}`;
+}
+function buildListJql(config, explicitJql) {
+    const jql = explicitJql?.trim() || config.jql.trim();
+    if (jql.length > 0) {
+        return jql;
+    }
+    const projectKey = config.projectKey.trim();
+    if (!projectKey) {
+        throw new ExternalIssueAdapterError('MISSING_CONFIG', 'Missing Jira project key/JQL. Pass --project-key or --jql, or set PRLT_JIRA_PROJECT/PRLT_JIRA_JQL.');
+    }
+    return `project = "${projectKey}" AND statusCategory != Done ORDER BY updated DESC`;
+}
+function getErrorMessage(payload, fallback) {
+    if (!payload || typeof payload !== 'object') {
+        return fallback;
+    }
+    const errorMessages = payload.errorMessages;
+    if (Array.isArray(errorMessages) && typeof errorMessages[0] === 'string' && errorMessages[0].trim()) {
+        return errorMessages[0].trim();
+    }
+    return fallback;
+}
+async function parseJsonOrThrow(response) {
+    try {
+        return await response.json();
+    }
+    catch {
+        throw new ExternalIssueAdapterError('BAD_PAYLOAD', 'Jira response was not valid JSON.');
+    }
+}
+function deriveJiraCategory(envelope) {
+    const typeValue = envelope.item_type?.trim().toLowerCase() || '';
+    if (typeValue === 'bug' || typeValue === 'incident') {
+        return 'bug';
+    }
+    if (typeValue === 'task' || typeValue === 'story' || typeValue === 'issue') {
+        return 'feature';
+    }
+    return 'feature';
+}
+function ensureIssueShape(issue) {
+    if (!issue.id || !issue.key || !issue.fields) {
+        throw new ExternalIssueAdapterError('BAD_PAYLOAD', 'Jira issue payload is missing required fields (id, key, fields).', issue);
+    }
+}
+export function normalizeJiraIssue(rawIssue) {
+    if (!rawIssue || typeof rawIssue !== 'object') {
+        throw new ExternalIssueAdapterError('BAD_PAYLOAD', 'Jira issue payload is invalid.', rawIssue);
+    }
+    const issue = rawIssue;
+    ensureIssueShape(issue);
+    const adapter = new JiraIssueAdapter();
+    return adapter.normalize(issue);
+}
+export function normalizeJiraIssueToEnvelope(rawIssue) {
+    const envelope = normalizeJiraIssue(rawIssue);
+    return toNormalizedEnvelope(envelope, deriveJiraCategory(envelope));
+}
+export function buildJiraTicketDescription(envelope) {
+    const body = envelope.description.trim();
+    const metadataLines = [
+        `- Source: ${envelope.source.name}`,
+        `- External key: ${envelope.source.externalKey}`,
+        `- External id: ${envelope.source.externalId}`,
+        `- URL: ${envelope.source.url}`,
+        `- Status: ${envelope.status}`,
+        `- Priority: ${envelope.priority || 'Unset'}`,
+        `- Labels: ${envelope.labels.length > 0 ? envelope.labels.join(', ') : 'None'}`,
+    ];
+    const parts = [
+        body,
+        '## External Issue Context',
+        metadataLines.join('\n'),
+    ].filter(Boolean);
+    return parts.join('\n\n');
+}
+export function buildJiraMetadata(envelope) {
+    return {
+        external_source: envelope.source.name,
+        external_key: envelope.source.externalKey,
+        external_id: envelope.source.externalId,
+        external_url: envelope.source.url,
+        external_raw: JSON.stringify(envelope.source.raw),
+    };
+}
+export function buildJiraSpawnContextMessage(envelope, additionalMessage) {
+    const lines = [
+        `External issue source: ${envelope.source.name}`,
+        `External issue key: ${envelope.source.externalKey}`,
+        `External issue id: ${envelope.source.externalId}`,
+        `External issue URL: ${envelope.source.url}`,
+    ];
+    if (additionalMessage?.trim()) {
+        lines.push('', additionalMessage.trim());
+    }
+    return lines.join('\n');
+}
+export function buildJiraIssueChoiceCommand(issueKey, projectId) {
+    let command = `prlt work jira --issue ${issueKey} --json`;
+    if (projectId) {
+        command += ` -P ${projectId}`;
+    }
+    return command;
+}
+export async function getJiraIssueByKey(configInput, issueKey, options) {
+    const config = ensureJiraConfig(configInput);
+    const fetchImpl = options?.fetchImpl || fetch;
+    const key = ensureIssueKey(issueKey);
+    const baseApiUrl = `${config.baseUrl}${DEFAULT_JIRA_API_PATH}`;
+    const fields = encodeURIComponent(JIRA_ISSUE_FIELDS.join(','));
+    const issueUrl = `${baseApiUrl}/issue/${encodeURIComponent(key)}?fields=${fields}`;
+    const response = await fetchImpl(issueUrl, {
+        method: 'GET',
+        headers: {
+            Accept: 'application/json',
+            Authorization: buildAuthHeader(config),
+        },
+    });
+    if (response.status === 401 || response.status === 403) {
+        throw new ExternalIssueAdapterError('AUTH_FAILED', 'Jira authentication failed. Verify your Jira credentials.');
+    }
+    if (response.status === 404) {
+        return null;
+    }
+    const payload = await parseJsonOrThrow(response);
+    if (!response.ok) {
+        const msg = getErrorMessage(payload, `Jira request failed with status ${response.status}.`);
+        throw new ExternalIssueAdapterError('REQUEST_FAILED', msg, payload);
+    }
+    return normalizeJiraIssueToEnvelope(payload);
+}
+export async function listJiraIssues(configInput, options) {
+    const config = ensureJiraConfig(configInput);
+    const fetchImpl = options?.fetchImpl || fetch;
+    const limit = Math.max(1, Math.min(options?.limit ?? 20, 100));
+    const jql = buildListJql(config, options?.jql);
+    const baseApiUrl = `${config.baseUrl}${DEFAULT_JIRA_API_PATH}`;
+    const response = await fetchImpl(`${baseApiUrl}/search`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            Authorization: buildAuthHeader(config),
+        },
+        body: JSON.stringify({
+            jql,
+            maxResults: limit,
+            fields: JIRA_ISSUE_FIELDS,
+        }),
+    });
+    if (response.status === 401 || response.status === 403) {
+        throw new ExternalIssueAdapterError('AUTH_FAILED', 'Jira authentication failed. Verify your Jira credentials.');
+    }
+    const payload = await parseJsonOrThrow(response);
+    if (!response.ok) {
+        const msg = getErrorMessage(payload, `Jira request failed with status ${response.status}.`);
+        throw new ExternalIssueAdapterError('REQUEST_FAILED', msg, payload);
+    }
+    const data = payload;
+    if (!Array.isArray(data.issues)) {
+        throw new ExternalIssueAdapterError('BAD_PAYLOAD', 'Jira response payload was missing issues array.', payload);
+    }
+    return data.issues.map(normalizeJiraIssueToEnvelope);
+}
+//# sourceMappingURL=jira.js.map

package/dist/lib/external-issues/jira.js.map

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

package/dist/lib/external-issues/linear.js

@@ -65,14 +65,15 @@ function priorityFromLinear(value) {
             return null;
     }
 }
-function ensureLinearConfig(config) {
+function ensureLinearConfig(config, options) {
     const apiKey = config.apiKey || process.env.LINEAR_API_KEY || process.env.PRLT_LINEAR_API_KEY;
     const team = config.team || process.env.PRLT_LINEAR_TEAM || process.env.LINEAR_TEAM_KEY;
     const apiUrl = config.apiUrl || process.env.PRLT_LINEAR_API_URL || DEFAULT_LINEAR_API_URL;
     if (!apiKey) {
         throw new ExternalIssueAdapterError('MISSING_CONFIG', 'Missing Linear API key. Set LINEAR_API_KEY or PRLT_LINEAR_API_KEY.');
     }
-    if (!team) {
+    const requireTeam = options?.requireTeam ?? true;
+    if (requireTeam && !team) {
         throw new ExternalIssueAdapterError('MISSING_CONFIG', 'Missing Linear team key. Pass --team or set PRLT_LINEAR_TEAM.');
     }
     return { apiKey, team, apiUrl };
@@ -180,7 +181,7 @@ export function buildLinearIssueChoiceCommand(issueIdentifier, projectId) {
  * Fetch a single Linear issue by identifier (for example, ENG-123) and normalize it.
  */
 export async function getLinearIssueByIdentifier(configInput, identifier, options) {
-    const config = ensureLinearConfig(configInput);
+    const config = ensureLinearConfig(configInput, { requireTeam: false });
     const fetchImpl = options?.fetchImpl || fetch;
     const response = await fetchImpl(config.apiUrl, {
         method: 'POST',
@@ -198,6 +199,9 @@ export async function getLinearIssueByIdentifier(configInput, identifier, option
     if (response.status === 401 || response.status === 403) {
         throw new ExternalIssueAdapterError('AUTH_FAILED', 'Linear authentication failed. Verify your LINEAR_API_KEY token.');
     }
+    if (response.status === 429) {
+        throw new ExternalIssueAdapterError('RATE_LIMITED', 'Linear API rate limit exceeded. Wait a moment and try again.');
+    }
     if (!response.ok) {
         throw new ExternalIssueAdapterError('REQUEST_FAILED', `Linear request failed with status ${response.status}.`);
     }
@@ -211,6 +215,9 @@ export async function getLinearIssueByIdentifier(configInput, identifier, option
         if (/not found/i.test(message)) {
             return null;
         }
+        if (/rate.?limit|too many requests|throttl/i.test(message)) {
+            throw new ExternalIssueAdapterError('RATE_LIMITED', `Linear API rate limit exceeded: ${message}`);
+        }
         throw new ExternalIssueAdapterError('REQUEST_FAILED', `Linear API error: ${message}`);
     }
     const node = payload.data?.issue;
@@ -242,6 +249,9 @@ export async function listLinearIssues(configInput, options) {
     if (response.status === 401 || response.status === 403) {
         throw new ExternalIssueAdapterError('AUTH_FAILED', 'Linear authentication failed. Verify your LINEAR_API_KEY token.');
     }
+    if (response.status === 429) {
+        throw new ExternalIssueAdapterError('RATE_LIMITED', 'Linear API rate limit exceeded. Wait a moment and try again.');
+    }
     if (!response.ok) {
         throw new ExternalIssueAdapterError('REQUEST_FAILED', `Linear request failed with status ${response.status}.`);
     }
@@ -251,6 +261,9 @@ export async function listLinearIssues(configInput, options) {
         if (/auth|token|forbidden|unauthorized/i.test(message)) {
             throw new ExternalIssueAdapterError('AUTH_FAILED', `Linear authentication failed: ${message}`);
         }
+        if (/rate.?limit|too many requests|throttl/i.test(message)) {
+            throw new ExternalIssueAdapterError('RATE_LIMITED', `Linear API rate limit exceeded: ${message}`);
+        }
         throw new ExternalIssueAdapterError('REQUEST_FAILED', `Linear API error: ${message}`);
     }
     const nodes = payload.data?.issues?.nodes;
@@ -259,3 +272,4 @@ export async function listLinearIssues(configInput, options) {
     }
     return nodes.map(normalizeLinearIssueToEnvelope);
 }
+//# sourceMappingURL=linear.js.map

package/dist/lib/external-issues/linear.js.map

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

package/dist/lib/external-issues/mapper.d.ts

@@ -15,7 +15,8 @@ import type { IssueEnvelope, IssueSpawnContext } from './types.js';
  * The mapping is deterministic: the same IssueEnvelope always produces
  * the same IssueSpawnContext.
  *
- * @param envelope - Validated IssueEnvelope
+ * @param input - IssueEnvelope-like input
  * @returns Spawn context with prompt and metadata
+ * @throws ExternalIssueError when input fails IssueEnvelope validation
  */
-export declare function mapToSpawnContext(envelope: IssueEnvelope): IssueSpawnContext;
+export declare function mapToSpawnContext(input: IssueEnvelope | unknown): IssueSpawnContext;

package/dist/lib/external-issues/mapper.js

@@ -4,6 +4,7 @@
  * Deterministically maps an IssueEnvelope to spawn context data
  * (prompt text + metadata) for agent execution.
  */
+import { validateOrThrow } from './validation.js';
 /**
  * Map an IssueEnvelope to spawn context data.
  *
@@ -14,10 +15,12 @@
  * The mapping is deterministic: the same IssueEnvelope always produces
  * the same IssueSpawnContext.
  *
- * @param envelope - Validated IssueEnvelope
+ * @param input - IssueEnvelope-like input
  * @returns Spawn context with prompt and metadata
+ * @throws ExternalIssueError when input fails IssueEnvelope validation
  */
-export function mapToSpawnContext(envelope) {
+export function mapToSpawnContext(input) {
+    const envelope = validateOrThrow(input);
     const prompt = buildPrompt(envelope);
     const metadata = buildMetadata(envelope);
     return { prompt, metadata };
@@ -84,3 +87,4 @@ function buildMetadata(envelope) {
     }
     return metadata;
 }
+//# sourceMappingURL=mapper.js.map

package/dist/lib/external-issues/mapper.js.map

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

package/dist/lib/external-issues/mapping-store.d.ts

@@ -0,0 +1,12 @@
+import Database from 'better-sqlite3';
+import { type ExternalExecutionMapping, type ExternalMappingProvider, type UpsertExternalExecutionMappingInput } from './types.js';
+export declare class ExternalExecutionMappingStore {
+    private db;
+    constructor(db: Database.Database);
+    private ensureTables;
+    upsertMapping(input: UpsertExternalExecutionMappingInput): ExternalExecutionMapping;
+    getByExternalId(provider: ExternalMappingProvider, externalId: string): ExternalExecutionMapping | null;
+    getByExternalKey(provider: ExternalMappingProvider, externalKey: string): ExternalExecutionMapping | null;
+    findByExecutionId(executionId: string): ExternalExecutionMapping[];
+    private rowToMapping;
+}

package/dist/lib/external-issues/mapping-store.js

@@ -0,0 +1,165 @@
+import { PMO_TABLES } from '../pmo/schema.js';
+const T = PMO_TABLES;
+function parseDate(value) {
+    return value ? new Date(value) : null;
+}
+function parseSnapshot(value) {
+    if (!value)
+        return null;
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Keep compatibility if old/invalid values are present.
+    }
+    return null;
+}
+export class ExternalExecutionMappingStore {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.ensureTables();
+    }
+    ensureTables() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${T.external_execution_map} (
+        provider TEXT NOT NULL CHECK (provider IN ('linear', 'jira', 'asana', 'monday', 'pmo')),
+        external_id TEXT NOT NULL,
+        external_key TEXT,
+        canonical_url TEXT,
+        latest_state_snapshot TEXT,
+        last_synced_at TIMESTAMP,
+        last_spawned_at TIMESTAMP,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (provider, external_id)
+      );
+
+      CREATE TABLE IF NOT EXISTS ${T.external_execution_links} (
+        provider TEXT NOT NULL,
+        external_id TEXT NOT NULL,
+        execution_id TEXT NOT NULL,
+        linked_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (provider, external_id, execution_id),
+        FOREIGN KEY (provider, external_id)
+          REFERENCES ${T.external_execution_map}(provider, external_id)
+          ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS ${T.external_execution_prs} (
+        provider TEXT NOT NULL,
+        external_id TEXT NOT NULL,
+        pr_url TEXT NOT NULL,
+        linked_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (provider, external_id, pr_url),
+        FOREIGN KEY (provider, external_id)
+          REFERENCES ${T.external_execution_map}(provider, external_id)
+          ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_pmo_external_execution_map_external_key
+        ON ${T.external_execution_map}(provider, external_key);
+      CREATE INDEX IF NOT EXISTS idx_pmo_external_execution_links_execution_id
+        ON ${T.external_execution_links}(execution_id);
+      CREATE INDEX IF NOT EXISTS idx_pmo_external_execution_prs_pr_url
+        ON ${T.external_execution_prs}(pr_url);
+    `);
+    }
+    upsertMapping(input) {
+        const snapshot = input.latestStateSnapshot === undefined
+            ? null
+            : JSON.stringify(input.latestStateSnapshot);
+        const lastSyncedAt = input.lastSyncedAt?.toISOString() ?? null;
+        const lastSpawnedAt = input.lastSpawnedAt?.toISOString() ?? null;
+        this.db.transaction(() => {
+            this.db.prepare(`
+        INSERT INTO ${T.external_execution_map}
+          (provider, external_id, external_key, canonical_url, latest_state_snapshot, last_synced_at, last_spawned_at, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+        ON CONFLICT(provider, external_id) DO UPDATE SET
+          external_key = COALESCE(excluded.external_key, ${T.external_execution_map}.external_key),
+          canonical_url = COALESCE(excluded.canonical_url, ${T.external_execution_map}.canonical_url),
+          latest_state_snapshot = COALESCE(excluded.latest_state_snapshot, ${T.external_execution_map}.latest_state_snapshot),
+          last_synced_at = COALESCE(excluded.last_synced_at, ${T.external_execution_map}.last_synced_at),
+          last_spawned_at = COALESCE(excluded.last_spawned_at, ${T.external_execution_map}.last_spawned_at),
+          updated_at = CURRENT_TIMESTAMP
+      `).run(input.provider, input.externalId, input.externalKey ?? null, input.canonicalUrl ?? null, snapshot, lastSyncedAt, lastSpawnedAt);
+            if (input.executionId) {
+                this.db.prepare(`
+          INSERT OR IGNORE INTO ${T.external_execution_links}
+            (provider, external_id, execution_id, linked_at)
+          VALUES (?, ?, ?, CURRENT_TIMESTAMP)
+        `).run(input.provider, input.externalId, input.executionId);
+            }
+            if (input.prUrl) {
+                this.db.prepare(`
+          INSERT OR IGNORE INTO ${T.external_execution_prs}
+            (provider, external_id, pr_url, linked_at)
+          VALUES (?, ?, ?, CURRENT_TIMESTAMP)
+        `).run(input.provider, input.externalId, input.prUrl);
+            }
+        })();
+        return this.getByExternalId(input.provider, input.externalId);
+    }
+    getByExternalId(provider, externalId) {
+        const row = this.db.prepare(`
+      SELECT * FROM ${T.external_execution_map}
+      WHERE provider = ? AND external_id = ?
+    `).get(provider, externalId);
+        if (!row)
+            return null;
+        return this.rowToMapping(row);
+    }
+    getByExternalKey(provider, externalKey) {
+        const row = this.db.prepare(`
+      SELECT * FROM ${T.external_execution_map}
+      WHERE provider = ? AND external_key = ?
+    `).get(provider, externalKey);
+        if (!row)
+            return null;
+        return this.rowToMapping(row);
+    }
+    findByExecutionId(executionId) {
+        const rows = this.db.prepare(`
+      SELECT m.*
+      FROM ${T.external_execution_map} m
+      INNER JOIN ${T.external_execution_links} l
+        ON m.provider = l.provider
+       AND m.external_id = l.external_id
+      WHERE l.execution_id = ?
+      ORDER BY m.updated_at DESC
+    `).all(executionId);
+        return rows.map((row) => this.rowToMapping(row));
+    }
+    rowToMapping(row) {
+        const executionIds = this.db.prepare(`
+      SELECT execution_id AS value
+      FROM ${T.external_execution_links}
+      WHERE provider = ? AND external_id = ?
+      ORDER BY linked_at DESC
+    `).all(row.provider, row.external_id);
+        const prUrls = this.db.prepare(`
+      SELECT pr_url AS value
+      FROM ${T.external_execution_prs}
+      WHERE provider = ? AND external_id = ?
+      ORDER BY linked_at DESC
+    `).all(row.provider, row.external_id);
+        return {
+            provider: row.provider,
+            externalId: row.external_id,
+            externalKey: row.external_key,
+            canonicalUrl: row.canonical_url,
+            latestStateSnapshot: parseSnapshot(row.latest_state_snapshot),
+            executionIds: executionIds.map((r) => r.value),
+            prUrls: prUrls.map((r) => r.value),
+            lastSyncedAt: parseDate(row.last_synced_at),
+            lastSpawnedAt: parseDate(row.last_spawned_at),
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+}
+//# sourceMappingURL=mapping-store.js.map

package/dist/lib/external-issues/mapping-store.js.map

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

package/dist/lib/external-issues/redact.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Credential Redaction Utilities for External Issue Spawn
+ *
+ * Ensures that API tokens, credentials, and other secrets are never
+ * leaked into logs, CLI output, stored metadata, or error messages.
+ */
+/**
+ * Redact known credential patterns from a string.
+ *
+ * Replaces matching substrings with `[REDACTED]`.
+ *
+ * @param input - String that may contain credentials
+ * @returns Sanitized string with credentials replaced
+ */
+export declare function redactCredentials(input: string): string;
+/**
+ * Check whether a string contains any known credential patterns.
+ *
+ * @param input - String to scan
+ * @returns Array of detected credential labels (empty if clean)
+ */
+export declare function detectCredentials(input: string): string[];
+/**
+ * Check whether a string contains any live secret values from the current environment.
+ *
+ * Looks up each SECRET_ENV_VAR in process.env and tests whether
+ * the input contains that value literally.
+ *
+ * @param input - String to scan
+ * @returns Array of env var names whose values appear in the input (empty if clean)
+ */
+export declare function detectEnvSecrets(input: string): string[];
+/**
+ * Scan a metadata record for credential leaks.
+ *
+ * Checks both keys and values for patterns that look like secrets.
+ *
+ * @param metadata - Key-value record to scan
+ * @returns Array of issues found (empty if clean)
+ */
+export declare function auditMetadata(metadata: Record<string, string>): string[];
+/**
+ * Assert that a string is free of credentials.
+ * Throws if any credentials are detected.
+ *
+ * @param input - String to check
+ * @param context - Description of what is being checked (for error message)
+ * @throws Error if credentials are found
+ */
+export declare function assertNoCredentials(input: string, context: string): void;