@principles/pd-cli 1.73.0

package/dist/commands/samples-review.d.ts

@@ -0,0 +1,14 @@
+/**
+ * pd samples review command implementation.
+ *
+ * Usage: pd samples review <sample-id> approve|reject [note]
+ */
+type ReviewDecision = 'approved' | 'rejected';
+interface SamplesReviewOptions {
+    sampleId: string;
+    decision: ReviewDecision;
+    note?: string;
+}
+export declare function handleSamplesReview(opts: SamplesReviewOptions): Promise<void>;
+export {};
+//# sourceMappingURL=samples-review.d.ts.map

package/dist/commands/samples-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples-review.d.ts","sourceRoot":"","sources":["../../src/commands/samples-review.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,KAAK,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9C,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnF"}

package/dist/commands/samples-review.js

@@ -0,0 +1,22 @@
+/**
+ * pd samples review command implementation.
+ *
+ * Usage: pd samples review <sample-id> approve|reject [note]
+ */
+import { reviewCorrectionSample } from '@principles/core/trajectory-store';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+export async function handleSamplesReview(opts) {
+    const workspaceDir = resolveWorkspaceDir();
+    try {
+        reviewCorrectionSample(opts.sampleId, opts.decision, opts.note, workspaceDir);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('Sample not found')) {
+            console.error(`Error: Sample not found: ${opts.sampleId}`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    console.log(`Sample ${opts.sampleId} marked as ${opts.decision}`);
+}
+//# sourceMappingURL=samples-review.js.map

package/dist/commands/samples-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples-review.js","sourceRoot":"","sources":["../../src/commands/samples-review.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAU9D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA0B;IAClE,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,QAAQ,cAAc,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/commands/task.d.ts

@@ -0,0 +1,14 @@
+interface TaskListOptions {
+    status?: string;
+    kind?: string;
+    limit?: number;
+}
+export declare function handleTaskList(opts: TaskListOptions): Promise<void>;
+interface TaskShowOptions {
+    id: string;
+    json?: boolean;
+    workspace?: string;
+}
+export declare function handleTaskShow(opts: TaskShowOptions): Promise<void>;
+export {};
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAWA,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzE;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DzE"}

package/dist/commands/task.js

@@ -0,0 +1,92 @@
+/**
+ * pd task list/show commands — Runtime v2 task inspection.
+ *
+ * Usage:
+ *   pd task list [--status <status>] [--kind <kind>] [--limit <n>]
+ *   pd task show <taskId>
+ */
+import * as path from 'path';
+import { RuntimeStateManager } from '@principles/core';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+export async function handleTaskList(opts) {
+    const workspaceDir = resolveWorkspaceDir();
+    const stateManager = new RuntimeStateManager({ workspaceDir });
+    await stateManager.initialize();
+    try {
+        const filter = {};
+        if (opts.status)
+            filter.status = opts.status;
+        if (opts.kind)
+            filter.taskKind = opts.kind;
+        if (opts.limit)
+            filter.limit = opts.limit;
+        const tasks = await stateManager.listTasks(Object.keys(filter).length > 0 ? filter : undefined);
+        if (tasks.length === 0) {
+            console.log('No tasks found.');
+            return;
+        }
+        console.log(`\nTasks (${tasks.length}):\n`);
+        console.log('%-22s %-12s %-10s %-4s/%-4s %-15s %s', 'TASK_ID', 'KIND', 'STATUS', 'ATT', 'MAX', 'LEASE_OWNER', 'LEASE_EXPIRES');
+        console.log('-'.repeat(90));
+        for (const task of tasks) {
+            const expiresAt = task.leaseExpiresAt
+                ? new Date(task.leaseExpiresAt).toLocaleString()
+                : '-';
+            console.log('%-22s %-12s %-10s %-4s %-4s %-15s %s', task.taskId.substring(0, 22), task.taskKind.substring(0, 12), task.status, task.attemptCount, task.maxAttempts, task.leaseOwner ?? '-', expiresAt.substring(0, 19));
+        }
+        console.log('');
+    }
+    finally {
+        await stateManager.close();
+    }
+}
+export async function handleTaskShow(opts) {
+    const workspaceDir = opts.workspace ? path.resolve(opts.workspace) : resolveWorkspaceDir();
+    const stateManager = new RuntimeStateManager({ workspaceDir });
+    await stateManager.initialize();
+    try {
+        const task = await stateManager.getTask(opts.id);
+        if (!task) {
+            console.error(`Task not found: ${opts.id}`);
+            process.exit(1);
+        }
+        const runs = await stateManager.getRunsByTask(opts.id);
+        if (opts.json) {
+            console.log(JSON.stringify({ task, runs }, null, 2));
+            return;
+        }
+        console.log(`\nTask: ${task.taskId}\n`);
+        console.log(`  Kind:          ${task.taskKind}`);
+        console.log(`  Status:        ${task.status}`);
+        console.log(`  Attempts:      ${task.attemptCount} / ${task.maxAttempts}`);
+        if (task.leaseOwner) {
+            console.log(`  Lease Owner:   ${task.leaseOwner}`);
+            console.log(`  Lease Expires: ${task.leaseExpiresAt ? new Date(task.leaseExpiresAt).toLocaleString() : '-'}`);
+        }
+        if (task.lastError) {
+            console.log(`  Last Error:    ${task.lastError}`);
+        }
+        if (task.inputRef) {
+            console.log(`  Input Ref:     ${task.inputRef}`);
+        }
+        if (task.resultRef) {
+            console.log(`  Result Ref:    ${task.resultRef}`);
+        }
+        console.log(`  Created:       ${new Date(task.createdAt).toLocaleString()}`);
+        console.log(`  Updated:       ${new Date(task.updatedAt).toLocaleString()}`);
+        console.log('');
+        if (runs.length > 0) {
+            console.log(`Runs (${runs.length}):`);
+            console.log('  %-22s %-12s %-6s %s', 'RUN_ID', 'STATUS', 'ATT', 'STARTED');
+            console.log('  ' + '-'.repeat(65));
+            for (const run of runs) {
+                console.log('  %-22s %-12s %-6s %s', run.runId.substring(0, 22), run.executionStatus, run.attemptNumber, new Date(run.startedAt).toLocaleString());
+            }
+            console.log('');
+        }
+    }
+    finally {
+        await stateManager.close();
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

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

package/dist/commands/trace.d.ts

@@ -0,0 +1,19 @@
+/**
+ * pd runtime trace show command — full pain-to-ledger chain trace.
+ *
+ * Usage: pd runtime trace show --pain-id <id> [--workspace <path>] [--json]
+ *
+ * Traces the complete pain→task→run→artifact→candidate→ledger chain
+ * and reports consistency, latency, and failure classification.
+ *
+ * PRI-129: Migrated from direct store/ledger usage
+ * to PainChainReadModel (ADR-0001 boundary compliance).
+ */
+interface TraceOptions {
+    painId: string;
+    workspace?: string;
+    json?: boolean;
+}
+export declare function handleTraceShow(opts: TraceOptions): Promise<void>;
+export {};
+//# sourceMappingURL=trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiDD,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFvE"}

package/dist/commands/trace.js

@@ -0,0 +1,154 @@
+/**
+ * pd runtime trace show command — full pain-to-ledger chain trace.
+ *
+ * Usage: pd runtime trace show --pain-id <id> [--workspace <path>] [--json]
+ *
+ * Traces the complete pain→task→run→artifact→candidate→ledger chain
+ * and reports consistency, latency, and failure classification.
+ *
+ * PRI-129: Migrated from direct store/ledger usage
+ * to PainChainReadModel (ADR-0001 boundary compliance).
+ */
+import * as path from 'path';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { PainChainReadModel } from '@principles/core/runtime-v2';
+function formatNoTaskResult(opts, workspaceDir, checkedAt) {
+    const taskId = `diagnosis_${opts.painId}`;
+    return {
+        painId: opts.painId,
+        taskId,
+        status: 'not_found',
+        failureCategory: 'runtime_unavailable',
+        message: `No task found for painId: ${opts.painId}`,
+        workspace: workspaceDir,
+        checkedAt,
+        missingLinks: ['task'],
+    };
+}
+function outputResult(result, opts) {
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`Pain ID:       ${result.painId}`);
+    console.log(`Task ID:       ${result.taskId}`);
+    console.log(`Status:        ${result.status}`);
+    if (result.runId)
+        console.log(`Run ID:        ${result.runId}`);
+    if (result.artifactId)
+        console.log(`Artifact ID:   ${result.artifactId}`);
+    if (result.candidateIds.length > 0)
+        console.log(`Candidate IDs:  ${result.candidateIds.join(', ')}`);
+    if (result.ledgerEntryIds.length > 0)
+        console.log(`Ledger Entries: ${result.ledgerEntryIds.join(', ')}`);
+    if (result.failureCategory)
+        console.log(`Failure:       ${result.failureCategory}`);
+    console.log(`Checked at:    ${result.checkedAt}`);
+    if (Object.keys(result.latencyMs).length > 0) {
+        console.log('\nLatency:');
+        if (result.latencyMs.painToTask)
+            console.log(`  pain→task:          ${result.latencyMs.painToTask}ms`);
+        if (result.latencyMs.taskToRun)
+            console.log(`  task→run:           ${result.latencyMs.taskToRun}ms`);
+        if (result.latencyMs.runToArtifact)
+            console.log(`  run→artifact:       ${result.latencyMs.runToArtifact}ms`);
+        if (result.latencyMs.artifactToCandidate)
+            console.log(`  artifact→candidate: ${result.latencyMs.artifactToCandidate}ms`);
+        if (result.latencyMs.candidateToLedger)
+            console.log(`  candidate→ledger:   ${result.latencyMs.candidateToLedger}ms`);
+    }
+    if (result.missingLinks.length > 0) {
+        console.log(`\nMissing links (${result.missingLinks.length}):`);
+        for (const link of result.missingLinks) {
+            console.log(`  - ${link}`);
+        }
+    }
+}
+export async function handleTraceShow(opts) {
+    if (!opts.painId) {
+        console.error('Error: --pain-id <id> is required');
+        process.exitCode = 1;
+        return;
+    }
+    const workspaceDir = opts.workspace
+        ? path.resolve(opts.workspace)
+        : resolveWorkspaceDir();
+    const readModel = new PainChainReadModel({ workspaceDir });
+    try {
+        const trace = await readModel.traceByPainId(opts.painId);
+        if (trace.status === 'not_found') {
+            const noTaskResult = formatNoTaskResult(opts, workspaceDir, trace.checkedAt);
+            if (opts.json) {
+                console.log(JSON.stringify(noTaskResult, null, 2));
+            }
+            else {
+                console.error(`Error: No task found for painId: ${opts.painId}`);
+                console.error(`  Derived taskId: ${noTaskResult.taskId}`);
+                console.error(`  Workspace: ${workspaceDir}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (trace.status === 'error') {
+            const isConfigError = trace.failureCategory === 'config_missing';
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    painId: trace.painId,
+                    taskId: trace.taskId,
+                    status: 'error',
+                    failureCategory: trace.failureCategory,
+                    message: isConfigError
+                        ? 'Failed to initialize state manager'
+                        : 'Internal error during trace',
+                    checkedAt: trace.checkedAt,
+                    missingLinks: trace.missingLinks,
+                }, null, 2));
+            }
+            else {
+                console.error(`Error: ${isConfigError ? 'Failed to open workspace' : 'Internal error during trace'}`);
+                console.error(`  Workspace: ${workspaceDir}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        const result = {
+            painId: trace.painId,
+            taskId: trace.taskId,
+            runId: trace.runId,
+            artifactId: trace.artifactId,
+            candidateIds: trace.candidateIds,
+            ledgerEntryIds: trace.ledgerEntryIds,
+            status: trace.status,
+            latencyMs: trace.latencyMs,
+            failureCategory: trace.failureCategory,
+            checkedAt: trace.checkedAt,
+            missingLinks: trace.missingLinks,
+        };
+        outputResult(result, opts);
+        if (result.status === 'error' || result.status === 'failed' || result.status === 'degraded') {
+            process.exitCode = 1;
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                painId: opts.painId,
+                taskId: `diagnosis_${opts.painId}`,
+                status: 'error',
+                failureCategory: 'runtime_unavailable',
+                message: msg,
+                checkedAt: new Date().toISOString(),
+                missingLinks: ['internal_error'],
+            }, null, 2));
+        }
+        else {
+            console.error(`Error: ${msg}`);
+        }
+        process.exitCode = 1;
+    }
+    finally {
+        await readModel.close();
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/commands/trace.js.map

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

package/dist/commands/trajectory.d.ts

@@ -0,0 +1,11 @@
+interface TrajectoryLocateOptions {
+    task?: string;
+    run?: string;
+    from?: string;
+    to?: string;
+    json?: boolean;
+    workspace?: string;
+}
+export declare function handleTrajectoryLocate(opts: TrajectoryLocateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=trajectory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/commands/trajectory.ts"],"names":[],"mappings":"AAWA,UAAU,uBAAuB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CzF"}

package/dist/commands/trajectory.js

@@ -0,0 +1,47 @@
+/**
+ * pd trajectory locate — Locate a trajectory by task ID, run ID, or time range.
+ *
+ * Usage:
+ *   pd trajectory locate --task <taskId> --workspace <path>
+ *   pd trajectory locate --run <runId> --workspace <path>
+ *   pd trajectory locate --from <date> --to <date> --workspace <path>
+ */
+import { SqliteConnection, SqliteTrajectoryLocator } from '@principles/core';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+export async function handleTrajectoryLocate(opts) {
+    const workspaceDir = resolveWorkspaceDir(opts.workspace);
+    const connection = new SqliteConnection(workspaceDir);
+    try {
+        const locator = new SqliteTrajectoryLocator(connection);
+        let query = {};
+        if (opts.task)
+            query = { taskId: opts.task };
+        else if (opts.run)
+            query = { runId: opts.run };
+        else if (opts.from || opts.to)
+            query = { timeRange: { start: opts.from ?? '', end: opts.to ?? '' } };
+        else {
+            console.error('Error: specify at least one search criterion (--task, --run, --from/--to)');
+            process.exit(1);
+        }
+        const result = await locator.locate(query);
+        if (result.candidates.length === 0) {
+            console.log('No trajectories found.');
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\nTrajectories (${result.candidates.length}):\n`);
+        for (const candidate of result.candidates) {
+            const reasonsCount = candidate.reasons.length;
+            console.log('  %s  confidence=%s  reasons=%d', candidate.trajectoryRef.substring(0, 36), candidate.confidence.toFixed(1), reasonsCount);
+        }
+        console.log('');
+    }
+    finally {
+        connection.close();
+    }
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/commands/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/commands/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAW9D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAA6B;IACxE,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAExD,IAAI,KAAK,GAA4B,EAAE,CAAC;QAExC,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aACxC,IAAI,IAAI,CAAC,GAAG;YAAE,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;aAC1C,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE;YAAE,KAAK,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;aAChG,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,CAAC;QAC/D,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9C,OAAO,CAAC,GAAG,CACT,iCAAiC,EACjC,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EACxC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAC/B,YAAY,CACb,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * pd CLI — Principles Disciple command-line interface.
+ *
+ * Usage:
+ *   pd pain record --reason <text> [--score N] [--source manual]
+ */
+export {};
+//# 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":";AACA;;;;;GAKG"}