@principles/pd-cli 1.144.0 → 1.145.1

package/dist/commands/codex-ingest-catchup.d.ts

@@ -0,0 +1,20 @@
+interface CodexIngestCatchUpOptions {
+    workspace?: string;
+    json?: boolean;
+    maxRollouts?: number;
+}
+export interface CodexIngestCatchUpReport {
+    generatedAt: string;
+    host: 'codex';
+    workspace: string;
+    status: 'ok' | 'degraded' | 'skipped';
+    reason?: string;
+    nextAction?: string;
+    rolloutsProcessed: number;
+    remainingLagRollouts: string[];
+    unexaminedRollouts: string[];
+    degradations: string[];
+}
+export declare function handleCodexIngestCatchUp(options: CodexIngestCatchUpOptions): Promise<void>;
+export {};
+//# sourceMappingURL=codex-ingest-catchup.d.ts.map

package/dist/commands/codex-ingest-catchup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-ingest-catchup.d.ts","sourceRoot":"","sources":["../../src/commands/codex-ingest-catchup.ts"],"names":[],"mappings":"AAwBA,UAAU,yBAAyB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAyCD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhG"}

package/dist/commands/codex-ingest-catchup.js

@@ -0,0 +1,95 @@
+/**
+ * pd codex ingest catch-up command implementation (Codex Governance Closure
+ * Slice C, PRI-624; SPEC §13/§15 recovery command).
+ *
+ * Performs ONE bounded non-destructive catch-up pass over the workspace's
+ * durable Codex checkpoints: resolves each previously-authenticated rollout
+ * by exact uuid, re-authorizes the transcript path, and resumes the bounded
+ * incremental ingestion from the checkpoint — then feeds any admission
+ * candidates through the same Slice B admission/continuation pass the hook
+ * uses. Flag-off (`codex_conversation_ingestion=false`) performs ZERO
+ * transcript filesystem I/O and reports a structured skip.
+ *
+ * This is the manual-mode counterpart of the Companion worker's catch-up
+ * step (worker cycle step 2); it creates no LLM execution.
+ *
+ * CLI gate compliance:
+ * - cli-1: --json outputs exactly one parseable JSON object on stdout.
+ * - cli-2: exit paths stop execution.
+ * - cli-5/6: skipped/degraded results carry reason + nextAction; nothing is
+ *   mutated on failure (the ingestion seam is transactional per rollout).
+ */
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { catchUpCodexIngestion } from '@principles/codex-adapter';
+function buildReport(generatedAt, workspace, result) {
+    if (result.status === 'skipped') {
+        return {
+            generatedAt,
+            host: 'codex',
+            workspace,
+            status: 'skipped',
+            reason: result.reason,
+            nextAction: result.nextAction,
+            rolloutsProcessed: 0,
+            remainingLagRollouts: [],
+            unexaminedRollouts: [],
+            degradations: [],
+        };
+    }
+    const degradations = [];
+    for (const rollout of result.rollouts) {
+        for (const degradation of rollout.admissionDegradations) {
+            degradations.push(`${rollout.rolloutIdentity}: ${degradation.reason}`);
+        }
+        if (rollout.outcome.status === 'degraded') {
+            degradations.push(`${rollout.rolloutIdentity}: ${rollout.outcome.reason}`);
+        }
+    }
+    return {
+        generatedAt,
+        host: 'codex',
+        workspace,
+        status: result.status,
+        rolloutsProcessed: result.rollouts.length,
+        remainingLagRollouts: [...result.remainingLagRollouts],
+        unexaminedRollouts: [...result.unexaminedRollouts],
+        degradations: degradations.slice(0, 10),
+        ...(degradations.length > 0 && result.status === 'degraded'
+            ? { reason: 'one or more rollouts degraded; committed observations remain durable', nextAction: 'Inspect the per-rollout degradations; re-run catch-up after fixing the underlying condition (Slice D adds the audited quarantine command).' }
+            : {}),
+    };
+}
+export async function handleCodexIngestCatchUp(options) {
+    const generatedAt = new Date().toISOString();
+    const workspace = resolveWorkspaceDir(options.workspace);
+    const result = await catchUpCodexIngestion({
+        workspaceDir: workspace,
+        env: { CODEX_HOME: process.env.CODEX_HOME },
+        ...(typeof options.maxRollouts === 'number' ? { maxRollouts: options.maxRollouts } : {}),
+    });
+    const report = buildReport(generatedAt, workspace, result);
+    if (options.json) {
+        console.log(JSON.stringify(report));
+        if (report.status === 'degraded')
+            process.exitCode = 1;
+        return;
+    }
+    const lines = [
+        `Codex ingestion catch-up (${workspace})`,
+        `  status:             ${report.status}`,
+        `  rollouts processed: ${report.rolloutsProcessed}`,
+        `  remaining lag:      ${report.remainingLagRollouts.length}`,
+        `  unexamined (bound): ${report.unexaminedRollouts.length}`,
+    ];
+    for (const degradation of report.degradations) {
+        lines.push(`  degradation: ${degradation}`);
+    }
+    if (report.reason !== undefined)
+        lines.push(`  reason: ${report.reason}`);
+    if (report.nextAction !== undefined)
+        lines.push(`  next action: ${report.nextAction}`);
+    console.log(lines.join('\n'));
+    if (report.status === 'degraded')
+        process.exitCode = 1;
+}
+//# sourceMappingURL=codex-ingest-catchup.js.map

package/dist/commands/codex-ingest-catchup.js.map

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

package/dist/commands/codex-worker.d.ts

@@ -0,0 +1,20 @@
+interface CodexWorkerOptions {
+    workspace?: string;
+    json?: boolean;
+    once?: boolean;
+    intervalMs?: number;
+    status?: boolean;
+}
+export interface CodexWorkerStatusReport {
+    generatedAt: string;
+    host: 'codex';
+    workspace: string;
+    mode: 'ready' | 'manual_action_required' | 'paused' | 'degraded';
+    registeredInInstallManifest: boolean;
+    reason?: string;
+    nextAction?: string;
+}
+export declare function handleCodexWorker(options: CodexWorkerOptions): Promise<void>;
+export {};
+/** SPEC §15 worker mode, evaluated without executing anything. */ 
+//# sourceMappingURL=codex-worker.d.ts.map

package/dist/commands/codex-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-worker.d.ts","sourceRoot":"","sources":["../../src/commands/codex-worker.ts"],"names":[],"mappings":"AA6BA,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,wBAAwB,GAAG,QAAQ,GAAG,UAAU,CAAC;IACjE,2BAA2B,EAAE,OAAO,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6ED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDlF;;AAED,kEAAkE"}

package/dist/commands/codex-worker.js

@@ -0,0 +1,156 @@
+/**
+ * pd codex worker command implementation (Codex Governance Closure Slice C,
+ * PRI-624; SPEC §13/§15; ADR-0020 §11.1).
+ *
+ * Runs the Workspace-scoped worker cycle — catch-up → reconciliation → one
+ * Diagnostician execution → one bounded downstream consumer cycle — either
+ * once (manual / Companion-supervised restart mode) or continuously.
+ *
+ * `status` answers the SPEC §15 worker-mode question without executing
+ * anything: `manual_action_required` means no Companion-registered worker
+ * serves this workspace (it is not in the install manifest) and the manual
+ * commands below are the recovery path.
+ *
+ * CLI gate compliance:
+ * - cli-1: --json is restricted to the single-output forms (--once / --status)
+ *   so stdout is exactly one parseable JSON object; continuous mode streams
+ *   human-readable reports instead (review P2).
+ * - cli-2: exit paths stop execution.
+ * - cli-6: paused/degraded modes carry reason + nextAction.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { runCodexWorkspaceWorkerCycle } from '@principles/codex-adapter';
+import { getInstallLayoutPaths, parseInstallManifest } from '@principles/install-layout';
+const DEFAULT_INTERVAL_MS = 120_000;
+async function printStatusReport(workspace, json) {
+    const generatedAt = new Date().toISOString();
+    const paths = getInstallLayoutPaths(os.homedir());
+    let registered = false;
+    let manifestError;
+    try {
+        const raw = JSON.parse(fs.readFileSync(paths.manifest, 'utf8'));
+        const parsed = parseInstallManifest(raw);
+        if (parsed.manifest !== undefined) {
+            registered = parsed.manifest.workspaces?.some((entry) => path.resolve(entry) === path.resolve(workspace)) ?? false;
+        }
+        else {
+            manifestError = parsed.error;
+        }
+    }
+    catch {
+        manifestError = 'install_manifest_unreadable';
+    }
+    // The status scan itself delegates mode computation to the cycle module's
+    // flag/config semantics by running a paused-compatible evaluation: a real
+    // cycle is NOT run (no execution, no lease, no transcript I/O).
+    const { computeCodexWorkerStatusMode } = await import('@principles/codex-adapter');
+    const evaluation = computeCodexWorkerStatusMode({ workspaceDir: workspace, registeredInInstallManifest: registered });
+    const report = {
+        generatedAt,
+        host: 'codex',
+        workspace,
+        mode: evaluation.mode,
+        registeredInInstallManifest: registered,
+        ...(evaluation.reason !== undefined ? { reason: evaluation.reason } : {}),
+        ...(evaluation.nextAction !== undefined ? { nextAction: evaluation.nextAction } : {}),
+        ...(manifestError !== undefined ? { reason: `${evaluation.reason ?? manifestError}` } : {}),
+    };
+    if (json) {
+        console.log(JSON.stringify(report));
+        return;
+    }
+    const lines = [
+        `Codex workspace worker status (${workspace})`,
+        `  mode: ${report.mode}`,
+        `  registered in install manifest: ${registered}`,
+    ];
+    if (report.reason !== undefined)
+        lines.push(`  reason: ${report.reason}`);
+    if (report.nextAction !== undefined)
+        lines.push(`  next action: ${report.nextAction}`);
+    console.log(lines.join('\n'));
+    if (report.mode === 'degraded')
+        process.exitCode = 1;
+}
+function printCycleReport(result, json) {
+    if (json) {
+        console.log(JSON.stringify(result));
+        return;
+    }
+    const lines = [
+        `Codex workspace worker (${result.workspaceDir})`,
+        `  mode: ${result.mode}${result.reason !== undefined ? ` (${result.reason})` : ''}`,
+    ];
+    if (result.report !== undefined) {
+        const { catchUp } = result.report;
+        const catchUpSummary = catchUp.status === 'skipped' ? `skipped (${catchUp.reason})` : `${catchUp.status} — processed=${catchUp.rollouts.length} lag=${catchUp.remainingLagRollouts.length}`;
+        lines.push(`  catch-up:    ${catchUpSummary}`);
+        lines.push(`  reconcile:   ok=${result.report.reconcile.ok} ensured=${result.report.reconcile.tasksEnsured} linksRepaired=${result.report.reconcile.linksRepaired}`);
+        if (result.report.diagnostician !== null) {
+            lines.push(`  diagnostician: ${result.report.diagnostician.status} (${result.report.diagnostician.taskId})`);
+        }
+        else {
+            lines.push('  diagnostician: none pending');
+        }
+        if (result.report.downstream !== null) {
+            lines.push(`  downstream:  ran=${result.report.downstream.ran}${result.report.downstream.taskKind !== undefined ? ` kind=${result.report.downstream.taskKind}` : ''}${result.report.downstream.skipReason !== undefined ? ` skip=${result.report.downstream.skipReason}` : ''}`);
+        }
+    }
+    if (result.nextAction !== undefined)
+        lines.push(`  next action: ${result.nextAction}`);
+    console.log(lines.join('\n'));
+}
+export async function handleCodexWorker(options) {
+    // cli-1: continuous mode streams one report per cycle — that is NOT one
+    // parseable JSON document. --json is only valid for the single-output
+    // forms (--once / --status), enforced here (review P2).
+    if (options.json === true && options.once !== true && options.status !== true) {
+        const error = {
+            generatedAt: new Date().toISOString(),
+            host: 'codex',
+            error: 'cli_contract',
+            reason: 'json_without_once_or_status',
+            nextAction: 'Use --json with --once (single cycle) or --status (no-op scan); continuous mode streams human-readable reports instead.',
+        };
+        console.log(JSON.stringify(error));
+        process.exitCode = 1;
+        return;
+    }
+    const workspace = resolveWorkspaceDir(options.workspace);
+    if (options.status === true) {
+        await printStatusReport(workspace, options.json === true);
+        return;
+    }
+    if (options.once === true) {
+        const result = await runCodexWorkspaceWorkerCycle({ workspaceDir: workspace, env: { CODEX_HOME: process.env.CODEX_HOME } });
+        printCycleReport(result, options.json === true);
+        if (result.mode === 'degraded')
+            process.exitCode = 1;
+        return;
+    }
+    const interval = typeof options.intervalMs === 'number' && options.intervalMs >= 1000 ? options.intervalMs : DEFAULT_INTERVAL_MS;
+    let stopped = false;
+    const onSignal = () => {
+        stopped = true;
+    };
+    process.on('SIGINT', onSignal);
+    process.on('SIGTERM', onSignal);
+    try {
+        while (!stopped) {
+            const result = await runCodexWorkspaceWorkerCycle({ workspaceDir: workspace, env: { CODEX_HOME: process.env.CODEX_HOME } });
+            printCycleReport(result, false);
+            if (stopped)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, interval));
+        }
+    }
+    finally {
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+    }
+}
+/** SPEC §15 worker mode, evaluated without executing anything. */ 
+//# sourceMappingURL=codex-worker.js.map

package/dist/commands/codex-worker.js.map

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

package/dist/commands/pain-list.d.ts

@@ -0,0 +1,45 @@
+/**
+ * pd pain list command — PRI-640 (Governance Signal Host Attribution v0.1)
+ *
+ * Read-only: lists canonical pain_events rows from trajectory.db with their
+ * host attribution. `--host` filters by openclaw / codex / unknown.
+ *
+ * Usage:
+ *   pd pain list [--workspace <path>] [--limit N] [--host openclaw|codex|unknown] [--json]
+ *
+ * Host semantics (SPEC §6/§12): host_kind is observability metadata only.
+ * NULL (legacy / manual / unprovable) is reported as `unknown` — never guessed.
+ * On a pre-PRI-640 database without the host_kind column every row reports
+ * `unknown` and a `host_kind_column_missing` warning is emitted (rc-9).
+ */
+export type PainListHostFilter = 'openclaw' | 'codex' | 'unknown';
+export interface PainListOptions {
+    workspace?: string;
+    limit?: number;
+    host?: string;
+    json?: boolean;
+}
+export interface PainListEntry {
+    /** Canonical pain identity; `row:<id>` when the legacy row has none. */
+    painId: string;
+    source: string;
+    /** 'openclaw' | 'codex' | 'unknown' — unknown covers NULL/unprovable. */
+    host: PainListHostFilter | 'unknown';
+    score: number;
+    severity: string | null;
+    createdAt: string;
+    runtimeTaskId: string | null;
+}
+export interface PainListResult {
+    count: number;
+    pains: PainListEntry[];
+    workspace: string;
+    hostFilter: PainListHostFilter | null;
+    warnings: string[];
+}
+export declare function listPains(dbPath: string, options?: {
+    limit?: number;
+    host?: PainListHostFilter;
+}): Promise<PainListResult>;
+export declare function handlePainList(opts: PainListOptions): Promise<void>;
+//# sourceMappingURL=pain-list.d.ts.map

package/dist/commands/pain-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-list.d.ts","sourceRoot":"","sources":["../../src/commands/pain-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoCD,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA+CpI;AAoBD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDzE"}

package/dist/commands/pain-list.js

@@ -0,0 +1,165 @@
+/**
+ * pd pain list command — PRI-640 (Governance Signal Host Attribution v0.1)
+ *
+ * Read-only: lists canonical pain_events rows from trajectory.db with their
+ * host attribution. `--host` filters by openclaw / codex / unknown.
+ *
+ * Usage:
+ *   pd pain list [--workspace <path>] [--limit N] [--host openclaw|codex|unknown] [--json]
+ *
+ * Host semantics (SPEC §6/§12): host_kind is observability metadata only.
+ * NULL (legacy / manual / unprovable) is reported as `unknown` — never guessed.
+ * On a pre-PRI-640 database without the host_kind column every row reports
+ * `unknown` and a `host_kind_column_missing` warning is emitted (rc-9).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function ownField(row, key) {
+    return isRecord(row) && Object.hasOwn(row, key) ? row[key] : undefined;
+}
+/** Runtime Contract #1/#4: validate each DB row; skip malformed rows loudly. */
+function toPainEntry(row) {
+    const id = ownField(row, 'id');
+    const source = ownField(row, 'source');
+    const score = ownField(row, 'score');
+    const createdAt = ownField(row, 'created_at');
+    if (typeof id !== 'number' || typeof source !== 'string' || typeof score !== 'number' || typeof createdAt !== 'string') {
+        return null;
+    }
+    const canonicalPainId = ownField(row, 'canonical_pain_id');
+    const hostKind = ownField(row, 'host_kind');
+    const severity = ownField(row, 'severity');
+    const runtimeTaskId = ownField(row, 'runtime_task_id');
+    const host = hostKind === 'openclaw' || hostKind === 'codex' ? hostKind : 'unknown';
+    return {
+        painId: typeof canonicalPainId === 'string' && canonicalPainId.length > 0 ? canonicalPainId : `row:${id}`,
+        source,
+        host,
+        score,
+        severity: typeof severity === 'string' ? severity : null,
+        createdAt,
+        runtimeTaskId: typeof runtimeTaskId === 'string' && runtimeTaskId.length > 0 ? runtimeTaskId : null,
+    };
+}
+export async function listPains(dbPath, options = {}) {
+    const Database = (await import('better-sqlite3')).default;
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const warnings = [];
+        const columns = db.prepare('PRAGMA table_info(pain_events)').all();
+        const hasHostKindColumn = columns.some((row) => ownField(row, 'name') === 'host_kind');
+        if (!hasHostKindColumn) {
+            warnings.push('host_kind_column_missing');
+        }
+        const params = [];
+        let query = 'SELECT id, source, score, severity, created_at, canonical_pain_id, runtime_task_id';
+        query += hasHostKindColumn ? ', host_kind' : ", NULL AS host_kind";
+        query += ' FROM pain_events WHERE 1=1';
+        if (options.host === 'unknown') {
+            query += hasHostKindColumn ? ' AND host_kind IS NULL' : '';
+        }
+        else if (options.host === 'openclaw' || options.host === 'codex') {
+            if (!hasHostKindColumn) {
+                return { count: 0, pains: [], workspace: path.dirname(path.dirname(dbPath)), hostFilter: options.host, warnings };
+            }
+            query += ' AND host_kind = ?';
+            params.push(options.host);
+        }
+        query += ' ORDER BY created_at DESC, id DESC';
+        const limit = options.limit ?? 20;
+        query += ' LIMIT ?';
+        params.push(limit);
+        const rawRows = db.prepare(query).all(...params);
+        const skipped = rawRows.length - rawRows.map(toPainEntry).filter((entry) => entry !== null).length;
+        if (skipped > 0) {
+            warnings.push(`malformed_rows_skipped:${skipped}`);
+        }
+        const pains = rawRows
+            .map(toPainEntry)
+            .filter((entry) => entry !== null);
+        return {
+            count: pains.length,
+            pains,
+            workspace: path.dirname(path.dirname(dbPath)),
+            hostFilter: options.host ?? null,
+            warnings,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+function printHuman(result) {
+    const filterNote = result.hostFilter ? ` (host: ${result.hostFilter})` : '';
+    console.log(`Pain events — ${result.count} shown${filterNote}`);
+    console.log('─'.repeat(96));
+    for (const pain of result.pains) {
+        const painId = pain.painId.length > 40 ? `${pain.painId.slice(0, 37)}...` : pain.painId;
+        console.log(`  ${pain.createdAt}  host=${pain.host.padEnd(8)} score=${String(pain.score).padEnd(3)} ${pain.severity ?? '-'.padEnd(6)} ${pain.source}`);
+        console.log(`    id: ${painId}${pain.runtimeTaskId ? ` | task: ${pain.runtimeTaskId}` : ''}`);
+    }
+    console.log('─'.repeat(96));
+    for (const warning of result.warnings) {
+        console.error(`WARN: ${warning}`);
+    }
+    if (result.warnings.includes('host_kind_column_missing')) {
+        console.error('Next: run `pd runtime init --workspace <dir>` (or restart the OpenClaw plugin) to migrate this workspace schema.');
+    }
+}
+export async function handlePainList(opts) {
+    const { workspace, limit: rawLimit, host: rawHost, json } = opts;
+    if (rawHost !== undefined && rawHost !== 'openclaw' && rawHost !== 'codex' && rawHost !== 'unknown') {
+        const message = `invalid host filter: expected openclaw | codex | unknown, got ${rawHost}`;
+        if (json) {
+            console.log(JSON.stringify({ status: 'failed', reason: 'invalid_host_filter', message, nextAction: 'Pass --host openclaw, --host codex, or --host unknown.' }));
+        }
+        else {
+            console.error('Error: ' + message);
+            console.error('Next: Pass --host openclaw, --host codex, or --host unknown.');
+        }
+        process.exit(1);
+        return; // guard: test stubs of process.exit continue execution (cli-2-exit-stops)
+    }
+    const hostFilter = rawHost;
+    let effectiveLimit = 20;
+    if (rawLimit !== undefined) {
+        if (!Number.isInteger(rawLimit) || rawLimit < 1 || rawLimit > 10000) {
+            const message = `invalid limit: limit must be an integer between 1 and 10000, got ${rawLimit}`;
+            if (json) {
+                console.log(JSON.stringify({ status: 'failed', reason: 'invalid_limit', message, nextAction: 'Pass --limit with a valid integer (1-10000).' }));
+            }
+            else {
+                console.error('Error: ' + message);
+                console.error('Next: Pass --limit with a valid integer (1-10000).');
+            }
+            process.exit(1);
+            return; // guard: test stubs of process.exit continue execution (cli-2-exit-stops)
+        }
+        effectiveLimit = rawLimit;
+    }
+    const workspaceDir = resolveWorkspaceDir(workspace);
+    const dbPath = path.join(workspaceDir, '.state', 'trajectory.db');
+    if (!fs.existsSync(dbPath)) {
+        const message = `trajectory database not found at ${dbPath}`;
+        if (json) {
+            console.log(JSON.stringify({ status: 'failed', reason: 'trajectory_db_not_found', message, nextAction: 'Initialize the PD workspace first (pd runtime init), or pass --workspace pointing at an initialized workspace.' }));
+        }
+        else {
+            console.error('Error: ' + message);
+            console.error('Next: Initialize the PD workspace first (pd runtime init), or pass --workspace pointing at an initialized workspace.');
+        }
+        process.exit(1);
+        return; // guard: test stubs of process.exit continue execution (cli-2-exit-stops)
+    }
+    const result = await listPains(dbPath, { limit: effectiveLimit, ...(hostFilter ? { host: hostFilter } : {}) });
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    printHuman(result);
+}
+//# sourceMappingURL=pain-list.js.map

package/dist/commands/pain-list.js.map

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

package/dist/commands/runtime-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-init.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqCH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwGD,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAwLhG;AA0DD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B/E"}
+{"version":3,"file":"runtime-init.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqCH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmHD,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAwLhG;AA0DD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B/E"}

package/dist/commands/runtime-init.js

@@ -48,12 +48,23 @@ const DB_NAMES = {
  */
 function buildConfigYaml(workspaceDir) {
     const config = getDefaultPdConfig();
+    // PRI-637: `pd runtime init` is PD machinery writing a bootstrap snapshot, so
+    // every flag entry records `source: 'system'` — an ORIGIN HINT, NOT proof that
+    // the value lacks Owner intent (direct .pd/config.yaml editing is a supported
+    // path; an Owner may later pin behavior on top of this entry). Labels are
+    // metadata only; effective values are unchanged. If a flag graduates, system-
+    // origin entries are cleanup CANDIDATES that still require explicit Owner
+    // confirmation before removal.
+    const features = {};
+    for (const [id, entry] of Object.entries(config.features)) {
+        features[id] = { category: entry.category, enabled: entry.enabled, source: 'system' };
+    }
     const yamlObj = {
         version: config.version,
         workspace: {
             default: workspaceDir,
         },
-        features: config.features,
+        features,
         runtimeProfiles: config.runtimeProfiles,
         internalAgents: config.internalAgents,
         ui: config.ui,