audit-tools 0.28.0

package/dist/shared/index.js

@@ -0,0 +1,112 @@
+export { FileDispositionStatusSchema, FileDispositionItemSchema, FileDispositionSchema, } from "./types/disposition.js";
+export { RiskItemSchema, RiskRegisterSchema } from "./types/risk.js";
+export { FLOW_CONFIDENCE_LEVELS, FlowConfidenceLevelSchema, CriticalFlowSchema, CriticalFlowManifestSchema, } from "./types/flows.js";
+export { SURFACE_KINDS, SurfaceKindSchema, SurfaceRecordSchema, SurfaceManifestSchema, } from "./types/surfaces.js";
+export { RUN_LEDGER_STATUSES } from "./types/runLedger.js";
+export { GraphEdgeSchema, RouteEdgeSchema, GraphBundleSchema, } from "./types/graph.js";
+export { AccessDeclarationSchema } from "./types/accessDeclaration.js";
+export { findingIdentity } from "./types/finding.js";
+// Zod schemas (A6 single source) — type inferred above, JSON schema generated.
+export { FindingSeveritySchema, FindingConfidenceSchema, FindingLocationSchema, FindingGroundingSchema, AnchorExpectationSchema, ExecutableAnchorSchema, FindingSchema, WorkBlockSchema, FindingThemeSchema, SynthesisNarrativeSchema, AuditFindingsSummarySchema, AuditFindingsReportSchema, } from "./types/finding.js";
+export { interpretFreeFormIntent } from "./intent/freeFormIntentInterpreter.js";
+export { decomposeIntent, assessClauseEncodability, interpretIntent, } from "./intent/clauseInterpreter.js";
+export { LensSchema, LENSES, VALID_LENSES, isLens, SEVERITIES, VALID_SEVERITIES, CONFIDENCES, VALID_CONFIDENCES, severityRank, confidenceRank, severityCompare, } from "./types/lens.js";
+export { detectRepoConventions, formatRepoConventions, } from "./tooling/repoConventions.js";
+export { StepStatusSchema, DispatchModelTierSchema, } from "./types/stepContract.js";
+export { PROVIDER_NAMES, SESSION_UI_MODES, PROVIDER_SECTION_KEYS, ANALYZER_SETTINGS, } from "./types/sessionConfig.js";
+// Contracts
+export { AUDITOR_REPORT_MARKER } from "./contracts.js";
+// OpenCode permission deployment helpers (global scope vs. agent scope)
+export { OPENCODE_MANAGED_BROAD_VALUE, withoutOpenCodeWildcard, mergeOpenCodeAgentPermissionRule, mergeOpenCodeGlobalPermissionRule, migrateOpenCodeGlobalExternalDirectory, } from "./opencodePermissions.js";
+export { AGENT_FEEDBACK_FILENAME, parseReflectionsNdjson, aggregateReflections, renderProcessFeedbackSection, ReflectionClaritySchema, ReflectionSeveritySchema, AgentReflectionSchema, } from "./agentReflections.js";
+// Tokens
+export { DEFAULT_CONTEXT_TOKENS, DEFAULT_OUTPUT_TOKENS, BLOCK_SAFETY_MARGIN, BYTES_PER_TOKEN, ESTIMATED_TOKENS_PER_LINE, ESTIMATED_PROMPT_OVERHEAD_TOKENS, ESTIMATED_ITEM_OVERHEAD_TOKENS, estimateTokensFromBytes, resolveContextBudget, } from "./tokens.js";
+// Concurrency: bounded, order-preserving parallel map
+export { mapWithConcurrency } from "./concurrency.js";
+// Id primitives: shared collision-disambiguation convention
+export { mintUniqueId } from "./ids.js";
+export { normalizeAnchorPath, normalizeTitle, findingIdentitySignature, findingIdentityFields, findingIdentityKey, } from "./findingIdentitySignature.js";
+export { hashContent } from "./hash.js";
+export { stableStringifyProjection, diffProjections, renderDiffReReviewSection, } from "./reReview/projectionDiff.js";
+export { runTracked, resolveExecArgv, quoteForCmd, shellQuote, renderPromptCommand, toPromptPathToken, quotePromptCommandArg, coerceJsonObjectArg, platformCommand, quoteForShellInterpreterCmd, stripClaudeCodeEnv, } from "./tooling/exec.js";
+export { ALLOWLISTED_EXEC_TIMEOUT_MS, ANCHOR_ALLOWLIST, GIT_READONLY_SUBCOMMANDS, executableBaseName, isAllowedAnchorCommand, runAllowlistedReadOnlyCommand, } from "./tooling/allowlistedExec.js";
+export { discoverProjectCommands } from "./tooling/testCommand.js";
+export { analyzerCacheRoot, parseAnalyzerSpec, resolveAnalyzerDep, installToCache, } from "./tooling/analyzerDeps.js";
+// Git helpers
+export { isGitRepo, gitRefExists, changedFiles, fileCommits, stagedAndUntracked, } from "./git.js";
+export { RunLogger } from "./observability/runLog.js";
+// IO
+export { isFileMissingError, isTransientFsError, withFsRetry, readJsonFile, writeJsonFile, appendNdjsonFile, readNdjsonFile, readOptionalJsonFile, readOptionalNdjsonFile, writeNdjsonFile, readOptionalTextFile, writeTextFile, } from "./io/json.js";
+// IO: canonical `.audit-tools/` path layout (single source for both CLIs)
+export { auditToolsDir, auditArtifactsDir, remediationArtifactsDir, stepsDir, incomingDir, } from "./io/auditToolsPaths.js";
+export { currentStepPath, currentPromptPath, writeStepContract, } from "./io/stepContractWriter.js";
+export { describeValue, isRecord, createValidationIssue, pushValidationIssue, prefixValidationIssues, formatValidationIssues, requireKeys, } from "./validation/basic.js";
+export { AUDIT_FINDINGS_CONTRACT_VERSION, validateAuditFindingsReport, isValidAuditFindingsReport, } from "./validation/findingsReport.js";
+export { validateSessionConfig } from "./validation/sessionConfig.js";
+export { normalizeForMatch, normalizeRepoPath, quoteMatches, verifyFindingGrounding, findingIsGrounded, findingNeedsVerificationBeforeFix, } from "./validation/findingGrounding.js";
+// Provider constants
+export { LOCAL_SUBPROCESS_PROVIDER_NAME, CODEX_PROVIDER_NAME, ANTIGRAVITY_PROVIDER_NAME, } from "./providers/constants.js";
+// Provider command runner (single source of truth for both orchestrators)
+export { spawnLoggedCommand } from "./providers/spawnLoggedCommand.js";
+export { resolveWorkerTaskTimeoutMs, applyWorkerTaskLaunchSettings, } from "./providers/workerTaskLaunch.js";
+export { resolveOpenCodeSpawnCommand } from "./providers/opencodeLaunch.js";
+// Shared structured provider launch/done diagnostics (single source so the
+// claude-code / opencode providers emit byte-identical stderr records).
+export { emitProviderLaunchDiagnostic, emitProviderDoneDiagnostic, } from "./providers/providerDiagnostics.js";
+// Provider-keyed strategy lookup primitive (unknown key → generic fallback).
+// Single-sources the quota error-parser + audit header-extractor factories.
+export { makeProviderKeyedFactory } from "./providers/providerKeyedFactory.js";
+// Shared provider classes. claude-code / opencode are now single-sourced here:
+// the principled default (prompt via stdin + launch/done diagnostics) is shared,
+// and the only per-orchestrator delta is the claude-code skip-permissions
+// default and the nested-session guard message (drift-plan E4). Each
+// orchestrator's providers/index.ts injects these via the factory deps.
+export { SubprocessTemplateProvider } from "./providers/subprocessTemplateProvider.js";
+export { LocalSubprocessProvider, MISSING_WORKER_COMMAND_MESSAGE, } from "./providers/localSubprocessProvider.js";
+export { CodexProvider } from "./providers/codexProvider.js";
+export { OpenAiCompatibleProvider, OPENAI_COMPATIBLE_PROVIDER_NAME, parseJsonLoose, } from "./providers/openAiCompatibleProvider.js";
+export { ClaudeCodeProvider, CLAUDE_CODE_PROVIDER_NAME, buildActiveClaudeCodeSessionMessage, } from "./providers/claudeCodeProvider.js";
+export { OpenCodeProvider, OPENCODE_PROVIDER_NAME, } from "./providers/opencodeProvider.js";
+export { resolveFreshSessionProviderName, createFreshSessionProvider, hasConfiguredOpenAiCompatible, } from "./providers/providerFactory.js";
+export { discoverProviders, queryProviderQuota, buildProviderConfirmationDisplay, applyProviderConfirmationSelections, } from "./providers/providerConfirmation.js";
+export { LimitSourceSchema, LimitConfidenceSchema, HostConcurrencyLimitSourceSchema, HostConcurrencyLimitSchema, ResolvedLimitsSchema, WaveBindingCapSchema, BackoffStateSchema, } from "./quota/types.js";
+export { QuotaUsageSnapshotSchema } from "./quota/quotaSource.js";
+export { resolveLimits, classifyProvider, resolveHostModel, agentHostFallbackConcurrency, DEFAULT_AGENT_HOST_CONCURRENCY, } from "./quota/limits.js";
+export { setQuotaStateDir, getQuotaStatePath, readQuotaState, writeQuotaState, computeMaxSafeConcurrency, recordWaveOutcome, clearBucketFailureEvidence, decayWeight, applyDecayToEntry, computeBackoffCooldownMs, computeBackoffFailureWeight, computeRampUpConcurrency, BASE_COOLDOWN_MS, MAX_COOLDOWN_MS, MAX_BUCKET_LEVEL, } from "./quota/state.js";
+export { detectRateLimitError, computeCooldownUntil, } from "./quota/errorParsing.js";
+// Shared claude-code stderr JSON-line scan (single source for the claude-code
+// error parser + audit header extractor).
+export { collectClaudeCodeJsonLines } from "./quota/claudeCodeJsonLines.js";
+export { detectHostActiveSubagentLimit, resolveHostActiveSubagentLimit, CODEX_DESKTOP_ACTIVE_SUBAGENT_LIMIT, } from "./quota/hostLimits.js";
+export { acquireLock, releaseLock, withFileLock, FileLockTimeoutError, STALE_LOCK_MS, } from "./quota/fileLock.js";
+export { runSlidingWindow } from "./quota/slidingWindow.js";
+export { scheduleWave, buildProviderModelKey, parseHostModelRoster, DEFAULT_SAFETY_MARGIN, DEFAULT_EMPIRICAL_HALF_LIFE_HOURS, DEFAULT_FIRST_CONTACT_CONCURRENCY, QUOTA_REMAINING_PCT_CRITICAL, QUOTA_REMAINING_PCT_LOW, } from "./quota/scheduler.js";
+export { HostModelRosterEntrySchema } from "./quota/scheduler.js";
+export { computeDispatchCapacity, summarizeDispatchCapacityPools, detectLivelock, buildEmptyPoolTerminal, } from "./quota/capacity.js";
+export { DispatchCapacityPoolSummarySchema } from "./quota/capacity.js";
+export { buildCacheablePrompt, DO_NOT_TOKEN_WRAP_NOTE, DISPATCH_PROMPT_HANDOFF_NOTE, } from "./prompts.js";
+export { renderHostAsset } from "./hostAssets.js";
+export { CONTRACT_PIPELINE_GOAL_SPEC_VERSION, CONTRACT_PIPELINE_CONTEXT_BUNDLE_VERSION, CONTRACT_PIPELINE_DESIGN_SPEC_VERSION, CONTRACT_PIPELINE_CONCEPTUAL_DESIGN_CRITIQUE_VERSION, CONTRACT_PIPELINE_OBLIGATION_LEDGER_VERSION, CONTRACT_PIPELINE_CONTRACT_ASSESSMENT_REPORT_VERSION, CONTRACT_PIPELINE_COUNTEREXAMPLE_VERSION, CONTRACT_PIPELINE_JUDGE_REPORT_VERSION, CONTRACT_PIPELINE_IMPLEMENTATION_DAG_VERSION, CONTRACT_PIPELINE_VERIFICATION_REPORT_VERSION, CONTRACT_PIPELINE_TEST_VALIDATOR_PLAN_VERSION, } from "./types/contractPipeline.js";
+export { detectObligationCycle, buildObligationLedger, } from "./types/obligationLedger.js";
+export { LearnedQuotaSource } from "./quota/learnedQuotaSource.js";
+export { scanStringAware } from "./parsing/stringAwareScanner.js";
+export { CompositeQuotaSource, buildQuotaSource } from "./quota/compositeQuotaSource.js";
+export { ClaudeOAuthQuotaSource, parseProviderModelKey, mapUsageToSnapshot, } from "./quota/claudeOAuthQuotaSource.js";
+export { fetchClaudeUsage } from "./quota/claudeOAuthQuotaSource.js";
+export { BaseHttpQuotaSource, fetchJsonOrNull, clampFraction, remainingFromUsedPercent, } from "./quota/httpQuotaSource.js";
+export { CodexQuotaSource, fetchCodexUsage, mapCodexUsage } from "./quota/codexQuotaSource.js";
+export { CopilotQuotaSource, fetchCopilotUsage, mapCopilotUsage } from "./quota/copilotQuotaSource.js";
+export { AntigravityQuotaSource, fetchAntigravityUsage, mapAntigravityUsage, } from "./quota/antigravityQuotaSource.js";
+export { OpenCodeQuotaSource } from "./quota/openCodeQuotaSource.js";
+export { GenericErrorParser, ClaudeCodeErrorParser, getErrorParserForProvider, } from "./quota/errorParsers/index.js";
+export { dropProvider, reroutePackets, } from "./quota/rollingEngine.js";
+export { LIVELOCK_PAUSE_LIMIT, filterNewProviders, checkLivelockGuard, advancePausedState, } from "./rolling/pausedState.js";
+// Single shared dispatch tier-rank authority (P1) — the ONE ordering of
+// DispatchModelTier, consolidating the previously-duplicated rank maps.
+export { DISPATCH_TIER_RANK, DISPATCH_TIER_ORDER, DISPATCH_TIER_RANK_FALLBACK, tierRank, compareTier, mostCapableTier, } from "./dispatch/tierRank.js";
+export { InFlightTokenTracker, scorePacketComplexity, selectProvider, createRollingDispatcher, } from "./dispatch/rollingDispatch.js";
+export { ROLLING_DISPATCH_ENGINE_VERSION } from "./types/rollingDispatch.js";
+export { PROVIDER_CONFIRMATION_RESULT_VERSION } from "./types/providerConfirmation.js";
+export { FREE_FORM_INTENT_INTERPRETATION_VERSION } from "./types/intentInterpretation.js";
+export { findFirstActionableObligation, findNextObligation, advance, DEFAULT_MAX_TRANSITIONS, } from "./engine/obligationEngine.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

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

package/dist/shared/intent/clauseInterpreter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Per-clause intent interpreter.
+ *
+ * Extends the free-form intent pipeline with per-clause encodability assessment.
+ * Fixes CE-005 (compound intent silently drops unrecognised directives) and
+ * CE-206 (total-encoding-failure check too coarse — single bad clause blocks
+ * all encodable clauses). Satisfies OBL-S10 / OBL-X07.
+ *
+ * Key invariant: ANY clause that cannot be encoded independently triggers a
+ * blocking checkpoint question; encodable clauses proceed regardless.
+ *
+ * All logic is pure and synchronous — no I/O, no LLM calls.
+ */
+/** The three signal kinds a clause can encode to. */
+export type IntentClauseKind = "lens_weight" | "priority_signal" | "scope_emphasis";
+/** Result of decomposing and assessing a single clause. */
+export interface IntentClause {
+    /** The original clause text (trimmed). */
+    text: string;
+    /** Whether this clause maps to at least one recognised signal. */
+    encodable: boolean;
+    /** Present when encodable is true. */
+    encoded_as?: {
+        kind: IntentClauseKind;
+        detail: string;
+    };
+    /** Present when encodable is false — a human/host-answerable blocking question. */
+    checkpoint_question?: string;
+}
+/** Output of interpretIntent — the top-level clause-aware result. */
+export interface ClauseInterpretResult {
+    /** One entry per discrete clause in the input. */
+    clauses: IntentClause[];
+    /**
+     * Subset of clauses that could not be encoded, promoted to blocking
+     * checkpoint questions that must be answered before planning proceeds.
+     */
+    checkpoint_questions: string[];
+    /** True when at least one clause could not be encoded. */
+    has_unencodable: boolean;
+}
+/**
+ * Split a compound free-form intent string into discrete single-purpose
+ * clauses. Splits on semicolons, " and ", newlines, and sentence boundaries
+ * (". " followed by an uppercase letter or end-of-string). Returns an empty
+ * array for empty/whitespace-only input.
+ *
+ * **Why commas do NOT split here:**
+ * This function is used in the *blocking-checkpoint* intent pipeline where
+ * each clause must be an independently assessable directive. A comma within a
+ * clause (e.g. "focus on modules A, B, and C") is part of that directive, not
+ * a clause separator. Splitting on commas would fragment such directives into
+ * unrecognisable pieces, producing spurious unencodable clauses.
+ *
+ * **Compare with `freeFormIntentInterpreter.decomposeClauses`:**
+ * That function splits on commas because it processes brief hint lists where
+ * commas are the primary separator (e.g. "security, performance"). Its output
+ * is a set of keyword-match inputs, not independently assessable directives.
+ *
+ * The two functions intentionally have different splitting rules. See
+ * `tests/maintainability-split-rules.test.mjs` for a regression assertion.
+ */
+export declare function decomposeIntent(free_form_intent: string): IntentClause[];
+/**
+ * Assess whether a single clause can be encoded as a planning signal.
+ *
+ * Returns a structured assessment — encodable: true if it maps to at least
+ * one signal kind; encodable: false with a checkpoint_question if it cannot.
+ */
+export declare function assessClauseEncodability(clause: string): {
+    encodable: boolean;
+    kind?: IntentClauseKind;
+    detail?: string;
+    checkpoint_question?: string;
+};
+/**
+ * Top-level clause-aware intent interpretation.
+ *
+ * Decomposes the free-form intent into clauses, assesses each independently,
+ * and promotes any unencodable clauses to blocking checkpoint questions.
+ * Encodable clauses proceed regardless of whether other clauses fail.
+ */
+export declare function interpretIntent(free_form_intent: string): ClauseInterpretResult;
+//# sourceMappingURL=clauseInterpreter.d.ts.map

package/dist/shared/intent/clauseInterpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clauseInterpreter.d.ts","sourceRoot":"","sources":["../../../src/shared/intent/clauseInterpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEpF,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,gBAAgB,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,YAAY,EAAE,CAyCxE;AA4CD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAgCA;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,qBAAqB,CAe/E"}

package/dist/shared/intent/clauseInterpreter.js

@@ -0,0 +1,183 @@
+/**
+ * Per-clause intent interpreter.
+ *
+ * Extends the free-form intent pipeline with per-clause encodability assessment.
+ * Fixes CE-005 (compound intent silently drops unrecognised directives) and
+ * CE-206 (total-encoding-failure check too coarse — single bad clause blocks
+ * all encodable clauses). Satisfies OBL-S10 / OBL-X07.
+ *
+ * Key invariant: ANY clause that cannot be encoded independently triggers a
+ * blocking checkpoint question; encodable clauses proceed regardless.
+ *
+ * All logic is pure and synchronous — no I/O, no LLM calls.
+ */
+import { LENS_KEYWORD_MAP, SCOPE_PATTERNS, PRIORITY_PATTERNS } from "./sharedIntentData.js";
+// ---------------------------------------------------------------------------
+// Decomposition
+// ---------------------------------------------------------------------------
+/**
+ * Split a compound free-form intent string into discrete single-purpose
+ * clauses. Splits on semicolons, " and ", newlines, and sentence boundaries
+ * (". " followed by an uppercase letter or end-of-string). Returns an empty
+ * array for empty/whitespace-only input.
+ *
+ * **Why commas do NOT split here:**
+ * This function is used in the *blocking-checkpoint* intent pipeline where
+ * each clause must be an independently assessable directive. A comma within a
+ * clause (e.g. "focus on modules A, B, and C") is part of that directive, not
+ * a clause separator. Splitting on commas would fragment such directives into
+ * unrecognisable pieces, producing spurious unencodable clauses.
+ *
+ * **Compare with `freeFormIntentInterpreter.decomposeClauses`:**
+ * That function splits on commas because it processes brief hint lists where
+ * commas are the primary separator (e.g. "security, performance"). Its output
+ * is a set of keyword-match inputs, not independently assessable directives.
+ *
+ * The two functions intentionally have different splitting rules. See
+ * `tests/maintainability-split-rules.test.mjs` for a regression assertion.
+ */
+export function decomposeIntent(free_form_intent) {
+    if (!free_form_intent || !free_form_intent.trim()) {
+        return [];
+    }
+    // Split on `;`, ` and ` (word boundary), newlines, and `. ` sentence breaks.
+    // We use a multi-step split so we can preserve ordering without a complex regex.
+    const raw = free_form_intent
+        // Normalise newlines
+        .replace(/\r\n/g, "\n")
+        // Split on semicolons
+        .split(/;/)
+        .flatMap((seg) => 
+    // Split each segment on " and " (word-boundary variant)
+    seg.split(/\band\b/i))
+        .flatMap((seg) => 
+    // Split on newlines
+    seg.split(/\n/))
+        .flatMap((seg) => {
+        // Split on ". " sentence boundaries (keep the remainder)
+        const parts = [];
+        let remaining = seg;
+        let match;
+        const sentenceRe = /\.\s+/g;
+        let lastIndex = 0;
+        sentenceRe.lastIndex = 0;
+        while ((match = sentenceRe.exec(remaining)) !== null) {
+            parts.push(remaining.slice(lastIndex, match.index + 1));
+            lastIndex = match.index + match[0].length;
+            // sentenceRe.lastIndex is already at lastIndex after exec; no reassignment needed.
+        }
+        parts.push(remaining.slice(lastIndex));
+        return parts;
+    })
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    // Assess each raw clause
+    return raw.map((text) => assessClauseEncodabilityAsClause(text));
+}
+// ---------------------------------------------------------------------------
+// Encodability assessment (internal helpers)
+// ---------------------------------------------------------------------------
+/** Return matched lens names for a clause. */
+function matchLenses(clause) {
+    const lower = clause.toLowerCase();
+    const matched = [];
+    for (const { keywords, lens } of LENS_KEYWORD_MAP) {
+        for (const kw of keywords) {
+            if (lower.includes(kw)) {
+                matched.push(lens);
+                break;
+            }
+        }
+    }
+    return matched;
+}
+/** Return true if the clause matches a scope-emphasis pattern. */
+function matchesScopeEmphasis(clause) {
+    return SCOPE_PATTERNS.some((p) => p.test(clause));
+}
+/** Return true if the clause signals urgency / priority. */
+function matchesPriority(clause) {
+    return PRIORITY_PATTERNS.some((p) => p.test(clause));
+}
+/** Generate a checkpoint question for an unencodable clause. */
+function generateCheckpointQuestion(clause) {
+    return (`The intent clause "${clause}" could not be encoded as a lens weight, ` +
+        `priority signal, or scope emphasis. How should this directive be applied ` +
+        `during planning and review? Please clarify the concrete action expected.`);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Assess whether a single clause can be encoded as a planning signal.
+ *
+ * Returns a structured assessment — encodable: true if it maps to at least
+ * one signal kind; encodable: false with a checkpoint_question if it cannot.
+ */
+export function assessClauseEncodability(clause) {
+    const text = clause.trim();
+    const lenses = matchLenses(text);
+    if (lenses.length > 0) {
+        return {
+            encodable: true,
+            kind: "lens_weight",
+            detail: `Matches lens(es): ${lenses.join(", ")}`,
+        };
+    }
+    if (matchesPriority(text)) {
+        return {
+            encodable: true,
+            kind: "priority_signal",
+            detail: `Contains urgency/priority keyword`,
+        };
+    }
+    if (matchesScopeEmphasis(text)) {
+        return {
+            encodable: true,
+            kind: "scope_emphasis",
+            detail: `Matches scope-emphasis pattern`,
+        };
+    }
+    return {
+        encodable: false,
+        checkpoint_question: generateCheckpointQuestion(text),
+    };
+}
+/** Internal variant that returns a full IntentClause object. */
+function assessClauseEncodabilityAsClause(text) {
+    const result = assessClauseEncodability(text);
+    if (result.encodable && result.kind && result.detail) {
+        return {
+            text,
+            encodable: true,
+            encoded_as: { kind: result.kind, detail: result.detail },
+        };
+    }
+    return {
+        text,
+        encodable: false,
+        checkpoint_question: result.checkpoint_question,
+    };
+}
+/**
+ * Top-level clause-aware intent interpretation.
+ *
+ * Decomposes the free-form intent into clauses, assesses each independently,
+ * and promotes any unencodable clauses to blocking checkpoint questions.
+ * Encodable clauses proceed regardless of whether other clauses fail.
+ */
+export function interpretIntent(free_form_intent) {
+    const clauses = decomposeIntent(free_form_intent);
+    const checkpoint_questions = [];
+    for (const clause of clauses) {
+        if (!clause.encodable && clause.checkpoint_question) {
+            checkpoint_questions.push(clause.checkpoint_question);
+        }
+    }
+    return {
+        clauses,
+        checkpoint_questions,
+        has_unencodable: checkpoint_questions.length > 0,
+    };
+}
+//# sourceMappingURL=clauseInterpreter.js.map

package/dist/shared/intent/clauseInterpreter.js.map

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

package/dist/shared/intent/freeFormIntentInterpreter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Free-form intent interpreter.
+ *
+ * Converts a free_form_intent string from IntentCheckpoint into structured
+ * priority/lens/scope signals consumed at planning time. The verbatim string
+ * is NEVER threaded into worker or dispatch prompts (INV-S04).
+ *
+ * All logic is pure and synchronous — no I/O, no LLM calls.
+ */
+import { LENS_KEYWORD_MAP, SCOPE_PATTERNS, PRIORITY_PATTERNS } from "./sharedIntentData.js";
+import type { Lens } from "../types/lens.js";
+export { LENS_KEYWORD_MAP, SCOPE_PATTERNS, PRIORITY_PATTERNS };
+/** Structured output emitted by interpretFreeFormIntent. */
+export interface InterpretedIntent {
+    /**
+     * Per-lens weight multipliers. A lens present here should receive boosted
+     * priority during planning (default boost = 1.5). Absent lenses get
+     * weight 1.0 (unchanged).
+     */
+    lensWeights: Partial<Record<Lens, number>>;
+    /**
+     * Clauses signalling urgency / high importance (e.g. "urgent", "critical",
+     * "most important"). Used to front-load planning work.
+     */
+    prioritySignals: string[];
+    /**
+     * Clauses that narrow or exclude scope (e.g. "focus on the auth module",
+     * "ignore vendor/").
+     */
+    scopeEmphasis: string[];
+    /**
+     * Clauses that could not be encoded as a lens weight, scope emphasis, or
+     * priority signal. Callers SHOULD promote these to blocking checkpoint
+     * questions rather than silently dropping them.
+     */
+    unencodableClauses: string[];
+}
+/**
+ * Interpret a free-form intent string into structured planning signals.
+ *
+ * - Empty / blank → zero-weight result with empty arrays.
+ * - Verbatim input string never appears in any output field.
+ * - Pure / synchronous — safe to call in deterministic planning paths.
+ */
+export declare function interpretFreeFormIntent(input: string): InterpretedIntent;
+//# sourceMappingURL=freeFormIntentInterpreter.d.ts.map

package/dist/shared/intent/freeFormIntentInterpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freeFormIntentInterpreter.d.ts","sourceRoot":"","sources":["../../../src/shared/intent/freeFormIntentInterpreter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAE/D,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C;;;OAGG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AA4ED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CA+CxE"}

package/dist/shared/intent/freeFormIntentInterpreter.js

@@ -0,0 +1,126 @@
+/**
+ * Free-form intent interpreter.
+ *
+ * Converts a free_form_intent string from IntentCheckpoint into structured
+ * priority/lens/scope signals consumed at planning time. The verbatim string
+ * is NEVER threaded into worker or dispatch prompts (INV-S04).
+ *
+ * All logic is pure and synchronous — no I/O, no LLM calls.
+ */
+import { LENS_KEYWORD_MAP, SCOPE_PATTERNS, PRIORITY_PATTERNS } from "./sharedIntentData.js";
+// Re-export shared data so callers that only import from this module keep working.
+export { LENS_KEYWORD_MAP, SCOPE_PATTERNS, PRIORITY_PATTERNS };
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_WEIGHT_BOOST = 1.5;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Split input into clauses on sentence, semicolon, comma, and newline
+ * boundaries.
+ *
+ * **Why comma-splitting is intentional here:**
+ * This function is used for free-form intent *hint* extraction where the input
+ * is a brief, comma-separated list of priorities (e.g. "security, performance,
+ * maintainability"). Commas are the most natural separator for such lists and
+ * splitting on them maximises individual lens keyword coverage.
+ *
+ * **Compare with `clauseInterpreter.decomposeIntent`:**
+ * That function is used for the *blocking-checkpoint* intent pipeline where
+ * clauses must be independently assessable and commas within a clause should
+ * NOT split it (e.g. "focus on modules A, B, and C" is one clause, not three).
+ * It therefore splits only on semicolons, " and ", newlines, and ". " sentence
+ * boundaries — NOT on commas.
+ *
+ * The two functions intentionally have different splitting rules. Any change to
+ * one should be evaluated against the contract of the other. See
+ * `tests/maintainability-split-rules.test.mjs` for a regression assertion that
+ * guards the difference.
+ */
+function decomposeClauses(input) {
+    return input
+        .split(/[.;,\n]+/)
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+}
+/** Return matched Lens values for a clause (may be empty). */
+function matchLenses(clause) {
+    const lower = clause.toLowerCase();
+    const matched = new Set();
+    for (const { keywords, lens } of LENS_KEYWORD_MAP) {
+        for (const kw of keywords) {
+            if (lower.includes(kw)) {
+                matched.add(lens);
+                break; // one keyword match is enough per entry
+            }
+        }
+    }
+    return [...matched];
+}
+/** Return the first scope-emphasis string for a clause, or null. */
+function matchScopeEmphasis(clause) {
+    for (const pattern of SCOPE_PATTERNS) {
+        const m = pattern.exec(clause);
+        if (m) {
+            return clause.trim();
+        }
+    }
+    return null;
+}
+/** Return true if the clause signals urgency/priority. */
+function matchesPriority(clause) {
+    return PRIORITY_PATTERNS.some((p) => p.test(clause));
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Interpret a free-form intent string into structured planning signals.
+ *
+ * - Empty / blank → zero-weight result with empty arrays.
+ * - Verbatim input string never appears in any output field.
+ * - Pure / synchronous — safe to call in deterministic planning paths.
+ */
+export function interpretFreeFormIntent(input) {
+    const result = {
+        lensWeights: {},
+        prioritySignals: [],
+        scopeEmphasis: [],
+        unencodableClauses: [],
+    };
+    if (!input || !input.trim()) {
+        return result;
+    }
+    const clauses = decomposeClauses(input);
+    for (const clause of clauses) {
+        let encoded = false;
+        // Lens matching
+        const lenses = matchLenses(clause);
+        if (lenses.length > 0) {
+            for (const lens of lenses) {
+                const current = result.lensWeights[lens] ?? 1.0;
+                // Accumulate boost — repeated mentions increase weight slightly.
+                result.lensWeights[lens] = Math.max(current, DEFAULT_WEIGHT_BOOST);
+            }
+            encoded = true;
+        }
+        // Priority signal
+        if (matchesPriority(clause)) {
+            result.prioritySignals.push(clause);
+            encoded = true;
+        }
+        // Scope emphasis
+        const scope = matchScopeEmphasis(clause);
+        if (scope !== null) {
+            result.scopeEmphasis.push(scope);
+            encoded = true;
+        }
+        if (!encoded) {
+            result.unencodableClauses.push(clause);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=freeFormIntentInterpreter.js.map

package/dist/shared/intent/freeFormIntentInterpreter.js.map

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

package/dist/shared/intent/sharedIntentData.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared keyword maps and patterns used by both the free-form intent
+ * interpreter and the per-clause intent interpreter. Single-sourced here
+ * so both modules stay in sync without duplication.
+ */
+import type { Lens } from "../types/lens.js";
+/** Maps normalised keyword fragments → Lens. Longer/more-specific entries first. */
+export declare const LENS_KEYWORD_MAP: Array<{
+    keywords: string[];
+    lens: Lens;
+}>;
+/** Patterns that signal scope emphasis (focus/ignore/prioritise). */
+export declare const SCOPE_PATTERNS: RegExp[];
+/** Patterns that signal urgency / priority. */
+export declare const PRIORITY_PATTERNS: RegExp[];
+//# sourceMappingURL=sharedIntentData.d.ts.map

package/dist/shared/intent/sharedIntentData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharedIntentData.d.ts","sourceRoot":"","sources":["../../../src/shared/intent/sharedIntentData.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAYtE,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,MAAM,EAQlC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAMrC,CAAC"}