peaks-loop 4.1.2 → 4.1.4

package/dist/cli/commands/audit-command-shared.js

@@ -0,0 +1,60 @@
+/**
+ * Shared plumbing for the `peaks audit *` command family.
+ *
+ * Split out of `audit-commands.ts` (file-size cap) so each runner module can
+ * read the option shapes, the `--project` validation and the two whitelists
+ * without importing the registrar back. Dependency direction is one-way:
+ * nothing here imports `audit-commands.ts`.
+ */
+import { existsSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getErrorMessage } from '../cli-helpers.js';
+export const SUPPORTED_ARTIFACT_KINDS = [
+    'decision',
+    'prompt',
+    'machine-output',
+    'narrative'
+];
+export function isSupportedArtifactKind(value) {
+    return SUPPORTED_ARTIFACT_KINDS.includes(value);
+}
+/** Whitelist of supported `--llm-provider` values for `peaks audit goal`. */
+export const SUPPORTED_LLM_PROVIDERS = ['anthropic', 'stub'];
+/**
+ * The real provider is the default: `peaks audit goal` is the entry gate for
+ * every peaks-* workflow, so it must audit by default and only scaffold when
+ * a caller explicitly asks for `stub`.
+ */
+export const DEFAULT_LLM_PROVIDER = 'anthropic';
+export function isSupportedLlmProvider(value) {
+    return SUPPORTED_LLM_PROVIDERS.includes(value);
+}
+/** The one hint every `--project` refusal carries, verbatim. */
+export const PROJECT_PATH_HINT = 'Verify the project path exists and is a directory';
+/** The one hint every scanner-failure refusal carries, verbatim. */
+export const SCANNER_HINT = 'Inspect scanner logs and re-run with the same --project path';
+export function validateProjectRoot(projectArg) {
+    const projectRoot = resolve(projectArg);
+    if (!existsSync(projectRoot)) {
+        return {
+            ok: false,
+            code: 'PROJECT_NOT_FOUND',
+            message: `project path does not exist: ${projectArg}`
+        };
+    }
+    let stat;
+    try {
+        stat = statSync(projectRoot);
+    }
+    catch (error) {
+        return { ok: false, code: 'INVALID_PROJECT', message: getErrorMessage(error) };
+    }
+    if (!stat.isDirectory()) {
+        return {
+            ok: false,
+            code: 'INVALID_PROJECT',
+            message: `project path is not a directory: ${projectArg}`
+        };
+    }
+    return { ok: true, projectRoot };
+}

package/dist/cli/commands/audit-commands.d.ts

@@ -1,41 +1,17 @@
 /**
  * peaks audit * CLI surface — Slice L2.1 + L2.3 P2-a.
  *
- * Registers the new `peaks audit` top-level command with the
- * `red-lines` (L2.1) and `static` (L2.3 P2-a) subcommands.
+ * Registers the `peaks audit` top-level command with the `red-lines` (L2.1),
+ * `static` (L2.3 P2-a), `prose-ratio`, `goal` and `artifact` subcommands.
  * Per `peaks-loop-when-adding-a-new-subcommand-check-for-existing-top-level-first.md`
  * we verified that no `peaks audit` top-level exists; this is the only
  * file that owns the registration.
+ *
+ * The action bodies live in `audit-<responsibility>-runners.ts` siblings; this
+ * file only wires the commands and delegates. Each delegate preserves the
+ * original callback's declared arity.
  */
 import type { Command } from 'commander';
-import { type AgentShieldState } from '../../services/audit/static-service.js';
 import { type ProgramIO } from '../cli-helpers.js';
-import type { AuditGoalOutput } from '../../services/audit/audit-goal-types.js';
-import type { RedLineAudit } from '../../services/audit/types.js';
-import { type AuditDecisionRecord } from '../../services/audit/decision-writer.js';
-/** `audit-failed` is a failure envelope's status — never a scaffold, never a success. */
-export type AuditGoalStatus = 'audit-complete' | 'scaffold-only' | 'audit-failed';
-export interface AuditGoalData {
-    readonly status: AuditGoalStatus;
-    /** Which LLM produced (or failed to produce) the audit. `unresolved` = rejected before binding. */
-    readonly providerBinding: 'anthropic-messages-api' | 'stub' | 'unresolved';
-    readonly need: string;
-    readonly projectRoot: string;
-    /** The validated 6-dimension audit. Present on success only. */
-    readonly result?: AuditGoalOutput;
-    /** The bound model. Present on a real run only. */
-    readonly model?: string;
-    /**
-     * Environment variables the binding needed and did not find. Present on a
-     * binding failure only, and verbatim: `fail()` redacts `message`, so this
-     * is the channel that reliably names what the operator must set.
-     */
-    readonly missingEnv?: readonly string[];
-}
-export interface StaticAuditData {
-    readonly audit: RedLineAudit;
-    readonly agentShield: AgentShieldState;
-    /** Populated only when `--record` is passed. Persisted decision record path. */
-    readonly decision?: AuditDecisionRecord;
-}
+export type { AuditGoalData, AuditGoalStatus, StaticAuditData } from './audit-command-shared.js';
 export declare function registerAuditCommands(program: Command, io: ProgramIO): void;