cclaw-cli 0.51.30 → 0.55.2

package/dist/artifact-linter/shared.d.ts

@@ -0,0 +1,246 @@
+import { type FlowStage, type FlowTrack } from "../types.js";
+export interface LintFinding {
+    section: string;
+    required: boolean;
+    rule: string;
+    found: boolean;
+    details: string;
+}
+export interface LintResult {
+    stage: string;
+    file: string;
+    passed: boolean;
+    findings: LintFinding[];
+}
+export declare function normalizeHeadingTitle(title: string): string;
+export type H2SectionMap = Map<string, string>;
+/**
+ * Collect H2 sections and body content (`## Section Name`).
+ *
+ * - Ignores lines that live inside fenced code blocks (``` / ~~~) so a
+ *   commented `## Approaches` inside an example doesn't open a phantom
+ *   section and swallow real content.
+ * - When the same heading appears more than once at the top level we
+ *   concatenate the bodies rather than silently overwriting the earlier
+ *   occurrence. This keeps lint rules honest when authors split a section
+ *   into multiple passes.
+ */
+export declare function extractH2Sections(markdown: string): H2SectionMap;
+export declare function headingPresent(sections: H2SectionMap, section: string): boolean;
+export declare function sectionBodyByName(sections: H2SectionMap, section: string): string | null;
+export declare function sectionBodyByAnyName(sections: H2SectionMap, sectionNames: string[]): string | null;
+export declare function sectionBodyByHeadingPrefix(sections: H2SectionMap, prefix: string): string | null;
+/**
+ * Build a regex that matches `<field>: <value>` even when the field name
+ * and/or value are wrapped in markdown emphasis (`*`, `**`, `_`, `__`).
+ *
+ * The shipped templates render fields as `- **Field name:** value`, so any
+ * structural check that searches for `Field:\s*token` against the rendered
+ * artifact must tolerate the closing `**` between the colon and the value.
+ *
+ * `field` is treated as literal text (regex meta-characters are escaped).
+ * `value` is inserted verbatim so callers can pass alternation
+ * (`STARTUP|BUILDER|...`). `flags` defaults to case-insensitive Unicode.
+ */
+export declare function markdownFieldRegex(field: string, value: string, flags?: string): RegExp;
+export declare function extractMarkdownSectionBody(markdown: string, section: string): string | null;
+export declare function headingLineIndex(markdown: string, section: string): number;
+export declare function parseShortCircuitStatus(sectionBody: string | null): string;
+export declare function isShortCircuitActivated(sectionBody: string | null): boolean;
+export declare function meaningfulLineCount(sectionBody: string): number;
+export declare function lineHasToken(line: string, token: string): boolean;
+export declare function countListItems(sectionBody: string): number;
+export declare function parseMarkdownTableRow(line: string): string[];
+export declare function tableHeaderCells(sectionBody: string): string[] | null;
+export declare function extractMinItemsFromRule(rule: string): number | null;
+export declare function tokensFromRule(rule: string): string[];
+export declare const VAGUE_AC_ADJECTIVES: string[];
+export declare function isSeparatorRow(line: string): boolean;
+export declare function getMarkdownTableRows(sectionBody: string): string[][];
+export type BinaryFlag = "yes" | "no" | "unknown";
+export declare function parseBinaryFlag(value: string): BinaryFlag;
+export declare function parseKeyedBinaryFlag(value: string, key: string): BinaryFlag;
+export declare function parseFailureModeRescueFlag(rescueCell: string): BinaryFlag;
+export declare function parseFailureModeTestFlag(rowText: string): BinaryFlag;
+export declare function validateFailureModeTable(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare const SCOPE_MODE_FULL_TOKENS: readonly string[];
+export type CanonicalScopeMode = (typeof SCOPE_MODE_FULL_TOKENS)[number];
+export declare const SCOPE_MODE_LINE_REGEX: RegExp;
+export declare const SCOPE_MODE_SHORT_TOKEN_REGEX: RegExp;
+export declare const SPEC_MAX_MODULES = 5;
+export declare const NEXT_STAGE_HANDOFF_REGEX: RegExp;
+export declare function hasCanonicalScopeMode(body: string): boolean;
+export declare function canonicalModesInText(text: string): CanonicalScopeMode[];
+export declare function shortModeToCanonical(text: string): CanonicalScopeMode | null;
+export declare function canonicalModeFromCandidate(candidate: string): CanonicalScopeMode | null;
+export declare function extractCanonicalScopeMode(body: string): CanonicalScopeMode | null;
+export declare function validatePremiseChallenge(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function validateScopeSummary(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare const APPROACH_ROLE_VALUES: readonly ["baseline", "challenger", "wild-card"];
+export declare const APPROACH_UPSIDE_VALUES: readonly ["low", "modest", "high", "higher"];
+export declare const REQUIREMENT_PRIORITY_VALUES: readonly ["P0", "P1", "P2", "P3", "DROPPED"];
+export declare function normalizeTableToken(value: string): string;
+export declare function columnIndex(header: string[], expected: string): number;
+export declare function validateApproachesTaxonomy(sectionBody: string): {
+    rowCount: number;
+    roleUpsideOk: boolean;
+    challengerOk: boolean;
+    details: string;
+};
+export declare function validateCalibratedSelfReview(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function validateRequirementsTaxonomy(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function validateLockedDecisionAnchors(sectionBody: string): {
+    ok: boolean;
+    anchors: string[];
+    details: string;
+};
+export interface InteractionEdgeCaseRequirement {
+    label: string;
+    pattern: RegExp;
+}
+export declare const INTERACTION_EDGE_CASE_REQUIREMENTS: readonly InteractionEdgeCaseRequirement[];
+export declare function validateInteractionEdgeCaseMatrix(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare const PRE_SCOPE_AUDIT_SIGNALS: ReadonlyArray<{
+    label: string;
+    pattern: RegExp;
+}>;
+export declare function validatePreScopeSystemAudit(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare const DIAGRAM_ARROW_PATTERN: RegExp;
+export declare const DIAGRAM_FAILURE_EDGE_PATTERN: RegExp;
+export declare const DIAGRAM_GENERIC_NODE_PATTERN: RegExp;
+export declare const TEST_COMMAND_MARKER_PATTERN: RegExp;
+export declare const RED_FAILURE_MARKER_PATTERN: RegExp;
+export declare const GREEN_SUCCESS_MARKER_PATTERN: RegExp;
+export declare function diagramEdgeLines(sectionBody: string): string[];
+export declare function hasFailureEdgeInDiagram(sectionBody: string): boolean;
+export declare function hasLabeledDiagramArrow(lines: string[]): boolean;
+export declare function hasAsyncDiagramEdge(lines: string[]): boolean;
+export declare function hasSyncDiagramEdge(lines: string[]): boolean;
+export declare function validateTddRedEvidence(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function validateTddGreenEvidence(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function validateVerificationLadder(sectionBody: string): {
+    ok: boolean;
+    details: string;
+};
+export declare function hasVerificationLadderTableRow(sectionBody: string): boolean;
+export type LearningEntryType = "rule" | "pattern" | "lesson" | "compound";
+export type LearningConfidence = "high" | "medium" | "low";
+export type LearningSeverity = "critical" | "important" | "suggestion";
+export type LearningUniversality = "project" | "personal" | "universal";
+export type LearningMaturity = "raw" | "lifted-to-rule" | "lifted-to-enforcement";
+export type LearningSource = "stage" | "retro" | "compound" | "idea" | "manual";
+export interface LearningSeedEntry {
+    type: LearningEntryType;
+    trigger: string;
+    action: string;
+    confidence: LearningConfidence;
+    severity?: LearningSeverity;
+    domain?: string | null;
+    stage?: FlowStage | null;
+    origin_stage?: FlowStage | null;
+    origin_run?: string | null;
+    frequency?: number;
+    universality?: LearningUniversality;
+    maturity?: LearningMaturity;
+    created?: string;
+    first_seen_ts?: string;
+    last_seen_ts?: string;
+    project?: string | null;
+    source?: LearningSource | null;
+    supersedes?: string[];
+    superseded_by?: string;
+}
+export interface LearningsParseResult {
+    ok: boolean;
+    none: boolean;
+    entries: LearningSeedEntry[];
+    errors: string[];
+    details: string;
+}
+export declare const LEARNING_TYPE_SET: Set<LearningEntryType>;
+export declare const LEARNING_CONFIDENCE_SET: Set<LearningConfidence>;
+export declare const LEARNING_SEVERITY_SET: Set<LearningSeverity>;
+export declare const LEARNING_UNIVERSALITY_SET: Set<LearningUniversality>;
+export declare const LEARNING_MATURITY_SET: Set<LearningMaturity>;
+export declare const LEARNING_SOURCE_SET: Set<LearningSource>;
+export declare const FLOW_STAGE_SET: Set<"brainstorm" | "scope" | "design" | "spec" | "plan" | "tdd" | "review" | "ship">;
+export declare const LEARNING_ALLOWED_KEYS: Set<string>;
+export declare function isIsoUtcTimestamp(value: string): boolean;
+export declare function isNullableString(value: unknown): value is string | null;
+export declare function isNullableStage(value: unknown): value is FlowStage | null;
+export declare function parseLearningSeedEntry(raw: unknown, index: number): {
+    ok: boolean;
+    entry?: LearningSeedEntry;
+    error?: string;
+};
+export declare function parseLearningsSection(sectionBody: string): LearningsParseResult;
+export declare function lineContainsVagueAdjective(text: string): string | null;
+export interface ParsedFrontmatter {
+    hasFrontmatter: boolean;
+    values: Record<string, string>;
+}
+export declare const FRONTMATTER_REQUIRED_KEYS: readonly ["stage", "schema_version", "version", "locked_decisions", "inputs_hash"];
+export declare const PLACEHOLDER_PATTERNS: Array<{
+    label: string;
+    regex: RegExp;
+}>;
+export declare const SCOPE_REDUCTION_PATTERNS: Array<{
+    label: string;
+    regex: RegExp;
+}>;
+export declare function parseFrontmatter(markdown: string): ParsedFrontmatter;
+export declare function extractDecisionIds(text: string): string[];
+export declare function extractRequirementIdsFromMarkdown(text: string): string[];
+export declare function extractLockedDecisionAnchors(text: string): string[];
+export declare function lockedDecisionHash(value: string): string;
+export declare function collectPatternHits(text: string, patterns: Array<{
+    label: string;
+    regex: RegExp;
+}>): string[];
+export declare function validateSectionBody(sectionBody: string, rule: string, sectionName: string): {
+    ok: boolean;
+    details: string;
+};
+export interface StageLintContext {
+    projectRoot: string;
+    stage: FlowStage;
+    track: FlowTrack;
+    raw: string;
+    absFile: string;
+    sections: H2SectionMap;
+    findings: LintFinding[];
+    parsedFrontmatter: ParsedFrontmatter;
+    brainstormShortCircuitBody: string | null;
+    brainstormShortCircuitActivated: boolean;
+    scopePreAuditEnabled: boolean;
+    staleDiagramAuditEnabled: boolean;
+    isTrivialOverride: boolean;
+    overrideSet: Set<string> | null;
+}