@fusengine/harness 0.1.79 → 0.1.81

package/dist/index-BIGVNQB8.d.mts

@@ -1,576 +0,0 @@
-import { t as Prompt } from "./types-DVbIl9md.mjs";
-
-//#region src/policy/detect-project.d.ts
-/** Project types detected from filesystem indicators. */
-type ProjectType = "nextjs" | "nuxt" | "angular" | "svelte" | "vue" | "react" | "tailwind" | "laravel" | "rails" | "django" | "python" | "go" | "rust" | "swift" | "java" | "scala" | "elixir" | "ruby" | "generic";
-/** Keywords that signal a development task (APEX trigger). */
-declare const DEV_KEYWORDS: RegExp;
-/** True when the prompt invokes the /apex command. */
-declare function isApexCommand(prompt: string): boolean;
-/** Modular architecture variants layered on top of the framework. */
-type ModularArchitecture = "fusecore" | "nextjs-modular" | null;
-/**
-* Detect a project-internal modular architecture (a sub-architecture the
-* framework-level {@link detectProjectType} doesn't capture): Fusengine's
-* FuseCore (Laravel) or a `modules/`-based Next.js layout.
-*/
-declare function detectModularArchitecture(dir: string): ModularArchitecture;
-/**
-* Resolve the skill a detected modular architecture forces.
-*
-* Ports the Python `check-nextjs-skill.py` / `check-laravel-skill.py` gates:
-* when the project is detected on disk as a modular architecture, a specific
-* skill is required ('solid-nextjs' for nextjs-modular, 'fusecore' for
-* fusecore). Returns `null` when no modular architecture is detected.
-*
-* @param cwd - Project root directory to scan.
-* @returns The forced skill name, or `null` when none applies.
-*/
-declare function requiredArchSkill(cwd: string): string | null;
-/** Detect the project type by scanning config files in `dir`. */
-declare function detectProjectType(dir: string): ProjectType;
-//#endregion
-//#region src/policy/detect-framework.d.ts
-/**
-* Detect a file's framework as the intersection of the REAL project (its nearest
-* manifest's capabilities) and the file's own extension/content signal. A
-* backend `.ts` in a react project is `generic` (no react signal) — fixing the
-* old extension-only default that flagged every `.ts` as react. Fail-open: any
-* error yields `"generic"`, never throws. Return values stay within the existing
-* union ("react" | "nextjs" | "laravel" | "swift" | "tailwind" | "java" | "go" |
-* "ruby" | "rust" | "generic") — no new labels.
-* @param filePath - Path of the file being written/edited.
-* @param content - Its (incoming) content, for JS content signals.
-* @param cwd - Root to resolve a relative `filePath` against (default cwd).
-* @returns A framework label from the existing union.
-*/
-declare function detectFramework(filePath: string, content: string, cwd?: string): string;
-//#endregion
-//#region src/policy/file-size.d.ts
-/**
-* Fixed marketplace plugins root — parity with Python `enforce-file-size.py`'s
-* literal, unexpanded `~/...` string. Exported: reused by
-* `policy/apex.ts::solidReadGate` for its "no reference matched" deny message.
-*/
-declare const PLUGINS_DIR = "~/.claude/plugins/marketplaces/fusengine-plugins/plugins";
-/**
-* Skill-dir fragment per framework — parity with Python
-* `enforce-file-size.py::get_solid_ref()` (falls back to `generic/`). Exported:
-* reused by `policy/apex.ts::solidReadGate` (see {@link PLUGINS_DIR}).
-*/
-declare const SOLID_REF: Record<string, string>;
-/** Verdict from {@link evaluateFileSize}. */
-interface FileSizeVerdict {
-  ok: boolean;
-  lines: number;
-  max: number;
-  message: string | null;
-}
-/**
-* Count physical lines — parity with the Python `enforce-file-size.py`
-* (`sum(1 for _ in f)`): every line counts (blanks and comments included), and a
-* single trailing newline does not add a phantom line. The SOLID ceiling is
-* measured on raw file length, not substantive code, to match the upstream plugin.
-*/
-declare function countLines(content: string): number;
-/**
-* Count non-empty, non-comment lines — parity with the Python `count_code_lines`
-* shared by the framework-specific SOLID validators: `_shared/scripts/validate_solid_common.py`
-* (imported by `nextjs-expert/scripts/validate-nextjs-solid.py` and
-* `swift-apple-expert/scripts/validate-swift-solid.py`), duplicated verbatim in
-* `react-expert/scripts/validate-react-solid.py` / `laravel-expert/scripts/validate-laravel-solid.py`.
-* Strips blank lines and lines starting with `//` or `*` — a SINGLE fixed rule
-* for all 4 callers (the Python `comment` param defaults to, and every real
-* call site leaves it at, `"//"` — never per-language despite covering
-* ts/tsx/js/jsx, php and swift).
-*
-* Deliberately distinct from two other "code-only" counters already in this
-* repo, neither of which is a faithful substitute here:
-*  - `countLoc` (`runtime/lifecycle/check-file-size.ts`): a genuinely
-*    per-language table (PHP additionally strips `#`, Python strips
-*    `#`/`"""`/`'''`) — ported from the unrelated `solid/scripts/check-file-size.py`.
-*  - `countCodeLines` (`runtime/lifecycle/aipilot/solid-compliance.ts`): also
-*    strips `#` — ported from `ai-pilot/scripts/check-solid-compliance.py`.
-* Reusing either would silently strip PHP `#`/Python-style comments that the
-* real react/nextjs/laravel/swift validators do NOT strip.
-* @param content - The file content to measure.
-*/
-declare function countFrameworkCodeLines(content: string): number;
-/**
-* Evaluate a file's line count against the SOLID limit.
-* @param lines - the file's line count
-* @param max - the limit (defaults to `resolveMaxLines()`)
-*/
-declare function evaluateFileSize(lines: number, max?: number, filePath?: string, framework?: string, displayLines?: number): FileSizeVerdict;
-//#endregion
-//#region src/policy/patterns.d.ts
-/** Destructive git operations to block outright. */
-declare const GIT_BLOCKED: ReadonlyArray<RegExp>;
-/** Git operations that warrant a confirmation prompt. */
-declare const GIT_ASK: ReadonlyArray<RegExp>;
-/** System-level package installs (need confirmation). */
-declare const SYSTEM_INSTALL: ReadonlyArray<RegExp>;
-/** Project-level package installs. */
-declare const PROJECT_INSTALL: ReadonlyArray<RegExp>;
-/** True when `cmd` matches any pattern in `patterns`. */
-declare function matchPatterns(cmd: string, patterns: ReadonlyArray<RegExp>): boolean;
-/** Git commands exempt from confirmation when Ralph mode is on (parity git-guard.py RALPH_SAFE). */
-declare const RALPH_SAFE: ReadonlyArray<string>;
-/**
-* OPT-IN autonomous "Ralph" mode: OFF unless `RALPH_MODE` is `1`/`true`, read
-* fresh on each call. Only the env var activates it — the Python source also
-* auto-enabled on a `.claude/ralph/prd.json` file or a `feature/*` branch, but
-* those silent activations are dropped here: a mode that removes git/install
-* confirmations must never turn on implicitly (owner: default OFF, env opt-in).
-*/
-declare function isRalphMode(): boolean;
-//#endregion
-//#region src/policy/interfaces/types.d.ts
-/** Harness-agnostic input to {@link evaluate}. */
-interface PolicyContext {
-  /** Tool name (e.g. "Write", "Edit", "Bash"). */
-  tool: string;
-  filePath?: string;
-  content?: string;
-  command?: string;
-  /** Optional override for the SOLID max-lines limit. */
-  maxLines?: number;
-  /** Subagent type — `Explore`/`Plan` are exempt from the file-size gate. */
-  agentType?: string;
-  /** Line count of the existing on-disk file (so an Edit on an oversized file blocks). */
-  existingLines?: number;
-  /** Edit only: full on-disk content, read once by the runtime (runtime/gate-helpers.ts::existingLineCounts) — lets evaluate() compute the exact post-edit line count instead of judging the stale pre-edit count alone. Undefined when unreadable/missing (fail-closed to the existingLines-only behavior). */
-  existingContent?: string;
-  /** Edit only: the tool_input.old_string being replaced (runtime/normalize.ts). Undefined for Write (no such field) — fail-closed. */
-  oldString?: string;
-  /** Edit only: the tool_input.replace_all flag — every occurrence of old_string is replaced, not just the first. */
-  isReplaceAll?: boolean;
-  /** Codex-only, populated by handle-pre.ts from the resolved `permission_mode` of an `approval_policy=never` session (adapters/codex/permission-mode.ts) — auto-approve gate, wired through evaluate.ts's anti-chaining check. */
-  neverApproval?: boolean;
-}
-/** Harness-agnostic policy decision (+ a portable prompt for adapters to render). */
-interface PolicyResult {
-  decision: "allow" | "deny" | "warn";
-  message: string | null;
-  prompt?: Prompt;
-  meta?: Record<string, unknown>;
-}
-//#endregion
-//#region src/policy/evaluate.d.ts
-/**
-* Evaluate a single tool-use against the bundled policies, returning a pure
-* decision plus a portable {@link Prompt}. Adapters translate the prompt into
-* their harness's native response (Claude `permissionDecision`, etc.).
-*/
-declare function evaluate(ctx: PolicyContext): PolicyResult;
-//#endregion
-//#region src/policy/guards/context.d.ts
-/** Context handed to every guard in the chain. */
-interface GuardContext {
-  tool: string;
-  filePath?: string;
-  content?: string;
-  command?: string;
-}
-/** A single guard: returns a blocking/asking Prompt, or null to continue. */
-type Guard = (ctx: GuardContext) => Prompt | null;
-//#endregion
-//#region src/policy/guards/security.d.ts
-/** A pattern paired with the violation label to name in the deny/ask reason. */
-interface LabeledPattern {
-  re: RegExp;
-  label: string;
-}
-/** Critical patterns that must always be blocked — parity `security_rules.py`'s cumulated violation names. */
-declare const CRITICAL_PATTERNS: LabeledPattern[];
-/** Patterns that warrant explicit confirmation before running — parity `security_rules.py`'s ask-level violation names. */
-declare const ASK_PATTERNS: LabeledPattern[];
-/**
-* Guards against dangerous Bash commands. Parity `security_rules.validate_command`
-* + `security-guard.py`: ACCUMULATE every matched violation, then deny when any
-* critical matched else ask, joining all violation labels in the reason. The
-* generic `rm` ask is exempt when the command targets a trash location (parity
-* `not re.search('trash', cmd)`).
-*/
-declare function securityGuard(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/guards/protected-path.d.ts
-/**
-* Path fragments that mark a location as internal/generated state.
-*
-* Parity with safe_paths.py: `~/.fuse-harness/cache` is a *writable*
-* cache the harness owns (lessons, MCP cache, per-type state) — only the
-* `cache/sessions` subtree is protected, not the whole cache.
-*/
-declare const PROTECTED_FRAGMENTS: readonly string[];
-/**
-* Matches a real `.git` directory segment (`/.git/`, `~/.git`, leading or
-* trailing `.git`) without matching unrelated names like `foo.git/` or
-* `.github/`. Kept separate from the substring fragments for precise scoping.
-*/
-declare const PROTECTED_GIT_RE: RegExp;
-/**
-* Blocks direct edits to internal/generated state directories.
-*
-* Covers:
-*  - Write / Edit tool calls whose `filePath` targets a protected fragment.
-*  - Bash commands whose actual write *target* is a protected fragment
-*    (read sources are ignored; see `extractWriteTargets`).
-*
-* @param ctx - The guard context (tool, filePath, command).
-* @returns A blocking {@link Prompt}, or null to allow.
-*/
-declare function protectedPathGuard(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/guards/bash-write-patterns.d.ts
-/** Redirect (`>`/`>>`) targeting a code-file extension. */
-declare const CODE_REDIRECT: RegExp;
-/**
-* Interpreters / tools that mutate source in place, plus heredoc-into-file —
-* split into labeled sub-patterns (parity bash-write-guard.py `DENY_PATTERNS`,
-* each with its own `desc`) so the deny reason names which motif matched
-* instead of a single generic message. Every command-named motif is
-* {@link CMD}-anchored (start/separator + optional wrapper chain); only the
-* structural heredoc-into-file motif is position-free.
-*/
-declare const CODE_MUTATORS: readonly {
-  re: RegExp;
-  desc: string;
-}[];
-/** Redirect to a non-code file. Excludes `/dev/null`, `2>`/`N>` and `>&N` fd
-* redirects via the `(?<![0-9&])` lookbehind + `(?!…|&)` (parity has_file_redirect). */
-declare const FILE_REDIRECT: RegExp;
-/** Other ambiguous file writers (ASK): `tee <file>` (not `tee -a`/path) and `dd … of=` —
-* labeled sub-patterns (parity bash-write-guard.py `ASK_PATTERNS`). */
-declare const ASK_WRITERS: readonly {
-  re: RegExp;
-  desc: string;
-}[];
-/** Commands whose first token never writes, skipped when a real redirect is
-* present (parity bash-write-guard.py `SAFE_PREFIXES`). */
-declare const SAFE_PREFIXES: readonly string[];
-/**
-* Session-state directory the freshness/APEX gates rely on. Any Bash command
-* touching it is a hook-bypass vector, so it is blocked outright — a blunt
-* substring match (read OR write), parity with bash-write-guard.py DENY_PATTERNS
-* `fusengine-cache/sessions` (rebranded to the harness cache path).
-*/
-declare const SESSION_STATE_FRAGMENT = ".fuse-harness/cache/sessions";
-//#endregion
-//#region src/policy/guards/bash-write.d.ts
-/**
-* Blocks shell commands that mutate code files in place (and heredocs/redirects
-* to source files); asks before other file-writing shell commands unless the
-* target is a harness-owned safe path. Forces use of the Write/Edit tool so
-* APEX/SOLID checks are not bypassed.
-*
-* The code-write detectors (CODE_MUTATORS, CODE_COMMAND_WRITE) run BEFORE the
-* SAFE_PREFIXES short-circuit: they are command-position anchored
-* (bash-command-anchor.ts), so a transparent wrapper (`env sed -i src/x.ts`,
-* `timeout 5 patch`, `cp a b; tee src/y.ts`) can no longer smuggle a code write
-* past its safe first token, while a quoted mention (`git commit -m "fix sed -i"`)
-* still falls through. The short-circuit becomes the terminal allow — "first
-* token never writes, nothing above matched".
-*/
-declare function bashWriteGuard(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/guards/interface-separation.d.ts
-/** TS/JS component files: top-level `interface`/`type Foo`. */
-declare const TS_DECL_RE: RegExp;
-/** Python view models: class subclassing a schema/protocol base. */
-declare const PY_MODEL_RE: RegExp;
-/**
-* PHP controllers: top-level `interface`, `abstract class`, or a concrete
-* `class …Interface/DTO/Request`. Union of the TS-only `abstract class` rule
-* and the Python rule (`class [A-Z].*(Interface|DTO|Request)`, enforce-interfaces.py:16).
-*/
-declare const PHP_DECL_RE: RegExp;
-/** Swift views: top-level `protocol Foo`. */
-declare const SWIFT_PROTO_RE: RegExp;
-/** Go handlers/controllers: top-level `type Foo interface`. */
-declare const GO_DECL_RE: RegExp;
-/** Java/Kotlin controllers/handlers: top-level `interface`/`record`. */
-declare const JAVA_DECL_RE: RegExp;
-/** Rust: top-level `trait Foo` declaration (captures the name for impl co-location). */
-declare const RUST_DECL_RE: RegExp;
-/**
-* Blocks top-level interface/type/protocol declarations in component, view or
-* controller files (Interface Segregation). Fires only when BOTH the path
-* category AND the content pattern match.
-*
-* Destination text for TS/JS/Vue/Svelte, PHP and Swift matches the user's own
-* `claude-rules/rules/04-solid-dry-rules.md` ("SOLID Skill per Stack" table),
-* the current authoritative convention — NOT the older `enforce-interfaces.py`
-* text, which this guard originally ported. Go/Python/Java/Kotlin aren't
-* covered by that table, so their destinations stay as a reasonable default.
-*
-* Parity note: enforce-interfaces.py only inspects `Write` (tool_input.content).
-* We deliberately also fire on `Edit` — an in-place edit can introduce the same
-* violation — and the path fragments accept singular *and* plural directory
-* names (`view/` + `views/`), mirroring the Python `s?` regexes.
-*/
-declare function interfaceSeparationGuard(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/guards/install.d.ts
-/**
-* Asks for confirmation before a dependency or system package install. In Ralph
-* mode (opt-in `RALPH_MODE`) a PROJECT install is auto-approved for autonomous
-* runs (parity install-guard.py:52), but a SYSTEM install always asks.
-*/
-declare function installGuard(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/guards/index.d.ts
-/** Ordered guard chain: critical/security + protected first, then writes/installs. */
-declare const GUARDS: ReadonlyArray<Guard>;
-/** Block prompt returned when a guard or gate throws (fail-closed). */
-declare const FAIL_CLOSED: Prompt;
-/** Register a user guard — runs AFTER the privileged core chain (two-tier). */
-declare function registerGuard(guard: Guard): void;
-/** Remove all registered user guards (mainly for tests). */
-declare function clearUserGuards(): void;
-/**
-* Run the guard chain — privileged core guards first, then user guards — and
-* return the first firing Prompt, else null. Fail-closed: a guard that throws
-* blocks (never silently passes).
-*/
-declare function runGuards(ctx: GuardContext): Prompt | null;
-//#endregion
-//#region src/policy/creation-intent.d.ts
-/**
-* True when a prompt expresses creation intent (a new feature/component) and is
-* not a fix/refactor — the signal that brainstorming should precede creation.
-* The harness calls this on UserPromptSubmit, then `recordBrainstormRequired`.
-*/
-declare function detectCreationIntent(prompt: string): boolean;
-//#endregion
-//#region src/policy/verbosity.d.ts
-/** Max results an exa MCP call may request. */
-declare const MAX_EXA_RESULTS = 3;
-/** Max token budget for exa `tokensNum` / context7 `tokens`. */
-declare const MAX_TOKENS = 2e3;
-/**
-* Cap an MCP call's verbosity — exa `numResults` ≤ 3 (+ `tokensNum` ≤ 2000),
-* Context7 `tokens` ≤ 2000. Returns the capped input (a mutation for the harness
-* to apply) when a change is needed, else null.
-*/
-declare function capVerbosity(tool: string, input: Record<string, unknown>): Record<string, unknown> | null;
-//#endregion
-//#region src/policy/framework-solid.d.ts
-/**
-* Framework-specific SOLID gate. Dispatches by extension/path to the matching
-* validator (React, Next.js, Laravel, Swift, Go, Rust) and returns a blocking
-* {@link Prompt} when any BLOCKING rule fires, or `null` when clean. Excluded
-* build/dependency paths (node_modules, dist, build, .next, vendor, .build,
-* DerivedData, Pods) early-return `null` to avoid false positives. Go and Rust
-* have no exclusion list yet (no vendor/target FPs reported) — additive only.
-* @param filePath - absolute path of the file being written/edited
-* @param content - the file (or new) content under validation
-* @param fileLines - full on-disk line count (set on Edit so a partial
-*   `new_string` snippet still judges the whole file, mirroring the base
-*   file-size guard / Python `get_full_file_content`). Omit on Write.
-*/
-declare function frameworkSolidGate(filePath: string, content: string, fileLines?: number): Prompt | null;
-//#endregion
-//#region src/policy/skill-trigger-patterns.d.ts
-/** Map of required sub-skill name → triggering code patterns, keyed by framework. */
-declare const SKILL_TRIGGERS: Readonly<Record<string, Readonly<Record<string, ReadonlyArray<string>>>>>;
-//#endregion
-//#region src/policy/skill-triggers.d.ts
-/**
-* Detect which sub-skills the written `content` requires for a `framework`.
-* Faithful to the Python `detect_required_skills`: first matching pattern per
-* skill wins. Most frameworks match case-insensitively (source `re.IGNORECASE`);
-* `swift` matches case-sensitively (see {@link CASE_SENSITIVE_FRAMEWORKS}).
-* @param framework - "react" | "nextjs" | "laravel" | "swift".
-* @param content - the code being written.
-* @returns required sub-skill names (empty when framework unknown / no match).
-*/
-declare function detectRequiredSkills(framework: string, content: string): string[];
-/**
-* True when `filePath`/`content` match the Python Tailwind gate's trigger
-* condition. React/Next.js components embed Tailwind utility classes in
-* `className` — this check fires IN ADDITION TO the primary framework gate,
-* never instead of it: {@link detectFramework} keeps returning "react"/
-* "nextjs" for these files (framework SOLID rules stay correct).
-*/
-declare function usesTailwindUtilities(filePath: string, content: string): boolean;
-/**
-* Block when a required sub-skill's `skills/<name>/` path is absent from
-* `refsRead`. Mirrors `specific_skill_consulted`, which confirms a skill was
-* read by checking the tracking file contains `skills/<name>/`.
-* @param framework - "react" | "nextjs" | "laravel".
-* @param content - the code being written.
-* @param refsRead - in-session read reference paths.
-* @param forcedSkill - a skill the detected modular architecture forces (optional).
-* @param cwd - project root; when set and not a shadcn project, `*-shadcn`
-*   requirements are skipped (ports the Python `is_shadcn_project` filter).
-* @param filePath - the file being written; when it's a `.tsx`/`.jsx` file
-*   with Tailwind utility classes in `className`, the "tailwind" domain
-*   skills are merged in alongside `framework`'s own (ports the separate
-*   `check-tailwind-skill.py` gate, independent of react/nextjs).
-* @returns a `block` Prompt naming the missing sub-skills, or `null` when satisfied.
-*/
-declare function skillTriggerGate(framework: string, content: string, refsRead: readonly string[], forcedSkill?: string | null, cwd?: string, filePath?: string): Prompt | null;
-//#endregion
-//#region src/policy/detect-claude-md-project-type.d.ts
-/**
-* Detect the project type from the cwd, reproducing the legacy Python logic:
-* package.json containing "next" → nextjs, else "react" → react; else
-* composer.json+artisan → laravel; else Package.swift / *.xcodeproj → swift;
-* else generic.
-* @param cwd - Project root to scan.
-* @returns The detected project type label.
-*/
-declare function detectClaudeMdProjectType(cwd: string): ProjectType;
-//#endregion
-//#region src/policy/claude-md-context.d.ts
-/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
-declare const DEV_VERBS: RegExp;
-/**
-* Build the APEX instruction preamble for a development task.
-* @param projectType - Detected project type label.
-* @param maxLines - SOLID per-file line ceiling.
-* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
-* @returns The APEX instruction text.
-*/
-declare function buildApexInstruction(projectType: ProjectType, maxLines: number, id?: string): string;
-/**
-* Build the UserPromptSubmit injection text: read the target's root
-* instructions doc (`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, ...) and,
-* when the prompt matches a dev verb, prepend the APEX instruction. Returns
-* `null` when the doc is absent/unreadable (the hook then emits nothing).
-* @param prompt - The raw user prompt.
-* @param cwd - Project root (for project-type detection).
-* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
-* @returns The injection text, or `null` to emit nothing.
-*/
-declare function buildClaudeMdContext(prompt: string, cwd: string, id?: string): string | null;
-//#endregion
-//#region src/policy/apex-task-context.d.ts
-/** Parsed task state injected into a Task sub-agent prompt. */
-interface ApexTaskState {
-  /** Current task id (defaults to "1"). */
-  id: string;
-  /** Task subject (defaults to ""). */
-  subject: string;
-  /** Current phase (defaults to "analyze"). */
-  phase: string;
-  /** Comma-joined consulted doc keys, or "none". */
-  docs: string;
-}
-/**
-* Read the current task state from `task.json`, reproducing the legacy Python
-* logic. Any read/parse error falls back to `("1", "", "analyze", "none")`.
-* @param taskFile - Absolute path to `.claude/apex/task.json`.
-* @returns The parsed {@link ApexTaskState}.
-*/
-declare function loadApexTaskState(taskFile: string): ApexTaskState;
-/**
-* Build the APEX context string injected into a Task sub-agent prompt.
-* @param state - The parsed task state.
-* @param maxLines - SOLID per-file line ceiling.
-* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
-* @returns The injection text.
-*/
-declare function buildApexTaskContext(state: ApexTaskState, maxLines: number, id?: string): string;
-/**
-* Build the PreToolUse Task injection, gated on the existence of the
-* project's target apex dir (`.claude/apex/`, `.codex/apex/`, ...). Returns
-* `null` when APEX is not active (no dir).
-* @param projectRoot - `CLAUDE_PROJECT_DIR` or cwd.
-* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
-* @returns The injection text, or `null` to emit nothing.
-*/
-declare function buildApexTaskInjection(projectRoot: string, id?: string): string | null;
-//#endregion
-//#region src/policy/cartographer/indicators.d.ts
-/**
-* Cartographer indicators — pure data sets used to detect a project root and to
-* exclude noise directories when walking a tree. Ports the constant tables from
-* `generate_project_map.py` / `write_recursive.py`.
-*/
-/** Filenames whose presence marks a directory as a project root. */
-declare const PROJECT_INDICATORS: ReadonlySet<string>;
-/** Directory names skipped entirely during the tree walk. */
-declare const EXCLUDE_DIRS: ReadonlySet<string>;
-//#endregion
-//#region src/policy/cartographer/frontmatter.d.ts
-/**
-* Extract a single frontmatter field's value from `text`. Strips surrounding
-* quotes; skips YAML block-scalar markers. Returns "" when absent.
-* @param text - The full document text.
-* @param field - The frontmatter key to read.
-* @returns The field value, or "".
-*/
-declare function parseField(text: string, field: string): string;
-/**
-* Derive a short description from the body following the frontmatter: the first
-* non-empty trimmed line, sliced to `maxLen`. Returns "" when none.
-* @param text - The full document text.
-* @param maxLen - Maximum length of the returned description.
-* @returns The body-derived description, or "".
-*/
-declare function parseBodyDesc(text: string, maxLen?: number): string;
-//#endregion
-//#region src/policy/cartographer/entry.d.ts
-/**
-* Tree-entry parsing — pure line regexes. Ports the line parsers of
-* `merge_index.py` and `track-enrichment.py`.
-*/
-/** A parsed `prefix[name](path) — desc` tree line. */
-interface TreeEntry {
-  prefix: string;
-  name: string;
-  path: string;
-  desc: string;
-}
-/**
-* Parse a `merge_index` tree line into its parts. Returns null on no match.
-* @param line - The raw tree line.
-* @returns The parsed entry, or null.
-*/
-declare function parseEntry(line: string): TreeEntry | null;
-/**
-* Parse an enrichment line into `[path, desc]`, requiring a non-empty desc.
-* @param line - The raw index line.
-* @returns The `[path, desc]` pair, or null.
-*/
-declare function parseEnrichment(line: string): [string, string] | null;
-//#endregion
-//#region src/policy/cartographer/describe.d.ts
-/**
-* First `# ` Markdown heading text (sans hashes), sliced to 60. "" when none.
-* @param text - The document text.
-* @returns The heading text, or "".
-*/
-declare function firstHeading(text: string): string;
-/**
-* First leading comment among the first 10 lines (`//`, `#` but not `#!`, or a
-* `"""`/`'''` docstring), sliced to 60. "" when none.
-* @param text - The source text.
-* @returns The comment text, or "".
-*/
-declare function firstComment(text: string): string;
-/**
-* Derive a description from a file's suffix + text. For `.md`, the supplied
-* frontmatter `description` (truncated) wins over the first heading; for known
-* source suffixes, the first comment; else "".
-* @param suffix - The file extension (with dot).
-* @param text - The file text.
-* @param mdField - The pre-parsed frontmatter `description` (md only).
-* @returns The derived description, or "".
-*/
-declare function descFromText(suffix: string, text: string, mdField: string): string;
-//#endregion
-//#region src/policy/seo/validate.d.ts
-/** True when `path` is an HTML-like file the SEO hook should validate. */
-declare function isHtmlLike(path: string): boolean;
-/**
-* Report the SEO elements missing from HTML-like content (title, meta
-* description, OG title/description/image, canonical, JSON-LD schema).
-* @param html - The file content.
-* @returns The missing element labels (empty when complete).
-*/
-declare function missingSeoElements(html: string): string[];
-//#endregion
-export { protectedPathGuard as $, FAIL_CLOSED as A, RUST_DECL_RE as B, usesTailwindUtilities as C, DEV_KEYWORDS as Ct, MAX_TOKENS as D, detectProjectType as Dt, MAX_EXA_RESULTS as E, detectModularArchitecture as Et, installGuard as F, ASK_WRITERS as G, TS_DECL_RE as H, GO_DECL_RE as I, FILE_REDIRECT as J, CODE_MUTATORS as K, JAVA_DECL_RE as L, clearUserGuards as M, registerGuard as N, capVerbosity as O, isApexCommand as Ot, runGuards as P, PROTECTED_GIT_RE as Q, PHP_DECL_RE as R, skillTriggerGate as S, detectFramework as St, frameworkSolidGate as T, ProjectType as Tt, interfaceSeparationGuard as U, SWIFT_PROTO_RE as V, bashWriteGuard as W, SESSION_STATE_FRAGMENT as X, SAFE_PREFIXES as Y, PROTECTED_FRAGMENTS as Z, DEV_VERBS as _, PLUGINS_DIR as _t, firstHeading as a, GuardContext as at, detectClaudeMdProjectType as b, countLines as bt, parseEntry as c, PolicyResult as ct, EXCLUDE_DIRS as d, PROJECT_INSTALL as dt, ASK_PATTERNS as et, PROJECT_INDICATORS as f, RALPH_SAFE as ft, loadApexTaskState as g, FileSizeVerdict as gt, buildApexTaskInjection as h, matchPatterns as ht, firstComment as i, Guard as it, GUARDS as j, detectCreationIntent as k, requiredArchSkill as kt, parseBodyDesc as l, GIT_ASK as lt, buildApexTaskContext as m, isRalphMode as mt, missingSeoElements as n, LabeledPattern as nt, TreeEntry as o, evaluate as ot, ApexTaskState as p, SYSTEM_INSTALL as pt, CODE_REDIRECT as q, descFromText as r, securityGuard as rt, parseEnrichment as s, PolicyContext as st, isHtmlLike as t, CRITICAL_PATTERNS as tt, parseField as u, GIT_BLOCKED as ut, buildApexInstruction as v, SOLID_REF as vt, SKILL_TRIGGERS as w, ModularArchitecture as wt, detectRequiredSkills as x, evaluateFileSize as xt, buildClaudeMdContext as y, countFrameworkCodeLines as yt, PY_MODEL_RE as z };

package/dist/index-BKZ67WMa.d.mts

@@ -1 +0,0 @@
-export { };

package/dist/index-BOBXQ91y.d.mts

@@ -1,12 +0,0 @@
-//#region src/freshness/trivial-edit-counter.d.ts
-/**
-* Increment a session's trivial-edit counter, evicting timestamps older than
-* `windowMs`. Decoupled + injectable `now` for testability.
-* @param filePath - session state file path
-* @param windowMs - sliding window in ms
-* @param now - current epoch ms (defaults to `Date.now()`)
-* @returns number of trivial edits within the window (including this one)
-*/
-declare function incrementTrivialEditCounter(filePath: string, windowMs: number, now?: number): Promise<number>;
-//#endregion
-export { incrementTrivialEditCounter as t };

package/dist/index-BVVgDSdq.d.mts

@@ -1 +0,0 @@
-export { };