@yagni-app/code-staging 0.3.2-staging.1112.1 → 0.3.2-staging.1115.1

package/dist/cli.js

@@ -22,6 +22,7 @@ import { claudeCompatArgs } from "./claudeCompat.js";
 import { agentDir, credentialsDir, piPackageDir } from "./credentials.js";
 import { DISTRIBUTION } from "./distribution.js";
 import { connectCommand } from "./connectClaudeCode.js";
+import { goCommand } from "./goHeadless.js";
 import { login } from "./login.js";
 import { logout } from "./logout.js";
 import { tokenCommand } from "./token.js";
@@ -288,6 +289,10 @@ export const HELP_TEXT = [
     "  yagni login              Authorize the active environment (device-code flow).",
     "  yagni logout             Revoke and clear the active environment's token.",
     "  yagni doctor             Check that everything is ready (green/red checklist).",
+    "  yagni go --headless      Run the /go pipeline without a session, for scripts",
+    "                           and CI: --ticket-file <path> [--plan-file <path>]",
+    "                           [--memo-file <path>] [--run-id <id>] [--json].",
+    "                           Exits 0 only on a reviewed, verified candidate.",
     "  yagni connect claude-code  Route Claude Code through the YAGNI model proxy",
     "                           (--project scopes to this repo; --off disconnects).",
     "  yagni connect codex      Route Codex CLI through the YAGNI model proxy.",
@@ -313,6 +318,8 @@ export const HELP_TEXT = [
     "The active environment is sticky; `use` switches it (prod is the default).",
     "Set YAGNI_BASE_URL to override the base URL for a single run.",
     "Set YAGNI_DISABLE_UPDATE_CHECK=1 to silence the new-version notice.",
+    "Set YAGNI_GO_TIER_CAP=<tier> to cap every pipeline stage at that tier",
+    "  (peak, advanced, standard, efficient). For eval and smoke lanes only.",
     "Set YAGNI_DISABLE_CLAUDE_COMPAT=1 to skip loading .claude assets.",
     "Set YAGNI_DISABLE_BRANDING=1 to pass the system prompt through unmodified.",
     "Set YAGNI_DISABLE_CRASH_REPORTS=1 to turn off sanitized crash reports.",
@@ -424,6 +431,12 @@ export async function main(argv) {
     if (command === "connect") {
         return connectCommand(rest);
     }
+    // The headless pipeline entry. `go` is a real subcommand, not passthrough:
+    // the interactive run stays `/go` inside a session, and a `yagni go` without
+    // --headless is refused with usage rather than launched as an agent prompt.
+    if (command === "go") {
+        return goCommand(rest, {}, cliVersion());
+    }
     if (command === "token") {
         return tokenCommand();
     }

package/dist/extension/hooks.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Lifecycle hooks system — user-configurable event hooks (YAG-506).
+ *
+ * Reads hook config from `~/.yagni-code/config.json` (user) and
+ * `.yagni-code/config.json` (project), and fires user-defined shell commands
+ * at lifecycle events. The config format mirrors Claude Code's `settings.json`
+ * hooks shape so a user can copy-paste between them.
+ *
+ * Supported events (8): SessionStart, UserPromptSubmit, PreToolUse,
+ * PostToolUse, PermissionRequest, PreCompact, PostCompact, SessionEnd.
+ *
+ * Exit code semantics (matching Claude Code / Codex):
+ *   0   = success; stdout parsed as JSON for structured decisions
+ *   2   = explicit block/deny (control events only); stderr = reason
+ *   other = hook failure; decision ignored, warning surfaced, normal flow
+ *
+ * Fail-soft: a broken hook degrades to "no hook," never to "broken session."
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/** A single hook command entry, matching Claude Code's wire format. */
+export interface HookEntry {
+    type: "command";
+    command: string;
+}
+/** A configured hook group with an optional matcher and source tag. */
+export interface HookGroup {
+    matcher?: string;
+    hooks: HookEntry[];
+    /** Where this group was loaded from. Project-level groups are gated on workspace trust. */
+    _source?: "user" | "project";
+}
+/** The hooks section of config.json. */
+export type HooksConfig = Record<string, HookGroup[]>;
+/** Supported Claude Code event names. */
+export type HookEventName = "SessionStart" | "UserPromptSubmit" | "PreToolUse" | "PostToolUse" | "PermissionRequest" | "PreCompact" | "PostCompact" | "SessionEnd";
+declare const SUPPORTED_EVENTS: readonly HookEventName[];
+/** Result of a PreToolUse hook evaluation. */
+export type PreToolUseHookResult = {
+    decision: "allow";
+} | {
+    decision: "deny";
+    reason: string;
+} | {
+    decision: "ask";
+} | null;
+/** Result of a PermissionRequest hook evaluation. */
+export type PermissionRequestHookResult = {
+    decision: "allow";
+} | {
+    decision: "deny";
+    reason: string;
+} | null;
+/** Interface injected into the permission gate. */
+export interface HookRunner {
+    preToolUse(toolName: string, input: Record<string, unknown>, cwd: string, trusted?: boolean): Promise<PreToolUseHookResult>;
+    permissionRequest(toolName: string, input: Record<string, unknown>, cwd: string, trusted?: boolean): Promise<PermissionRequestHookResult>;
+}
+/** Read and merge hooks config from user and project files. Pure I/O, fail-soft. */
+export declare function loadHooksConfig(userHome?: string, cwd?: string, env?: NodeJS.ProcessEnv): HooksConfig;
+/**
+ * Check if a matcher matches a tool name. Matches Claude Code / Codex:
+ * - No matcher → matches everything
+ * - "*" → matches everything
+ * - Exact string or pipe-separated alternatives ("Edit|Write") → exact match
+ * - Contains regex chars → regex match
+ */
+export declare function matchesMatcher(matcher: string | undefined, input: string | undefined): boolean;
+interface ExecResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    error: string | null;
+    durationMs: number;
+}
+/** Execute a hook command with stdin JSON, timeout, and fail-soft. */
+declare function execHook(command: string, inputJson: string, cwd: string, timeoutMs?: number, env?: NodeJS.ProcessEnv): Promise<ExecResult>;
+/** Extract permissionDecision from PreToolUse stdout JSON. */
+export declare function parsePreToolUseOutput(stdout: string): PreToolUseHookResult;
+/** Extract decision from PermissionRequest stdout JSON. */
+export declare function parsePermissionRequestOutput(stdout: string): PermissionRequestHookResult;
+/** Extract additionalContext from stdout JSON (for SessionStart, UserPromptSubmit, PostToolUse). */
+export declare function parseAdditionalContext(stdout: string): string | null;
+/** Check if stdout JSON has continue: false (for PreCompact cancellation). */
+export declare function parseCompactCancel(stdout: string): boolean;
+interface HookExecutorOptions {
+    config: HooksConfig;
+    env?: NodeJS.ProcessEnv;
+    execImpl?: typeof execHook;
+    /** Returns true when the workspace is trusted (pi's project trust model). */
+    isTrusted?: () => boolean;
+}
+/**
+ * Create a HookRunner for injection into the permission gate. The `isTrusted`
+ * function is called per hook invocation to gate project-level hooks on
+ * workspace trust (pi's project trust model). Defaults to always-trusted.
+ */
+export declare function makeHookRunner(opts: HookExecutorOptions): HookRunner | null;
+export interface RegisterHooksDeps {
+    config?: HooksConfig;
+    env?: NodeJS.ProcessEnv;
+    execImpl?: typeof execHook;
+    /** Returns true when the workspace is trusted (pi's project trust model). */
+    isTrusted?: () => boolean;
+}
+/**
+ * Register pi event handlers for all configured lifecycle hooks.
+ * No-op if no hooks are configured or in eval mode.
+ */
+export declare function registerHooks(pi: ExtensionAPI, deps?: RegisterHooksDeps): void;
+export { SUPPORTED_EVENTS as HOOK_SUPPORTED_EVENTS };
+//# sourceMappingURL=hooks.d.ts.map