cclaw-cli 7.7.1 → 8.1.0

package/dist/knowledge-store.d.ts

@@ -1,164 +1,20 @@
-import { type FlowStage } from "./types.js";
-export type KnowledgeEntryType = "rule" | "pattern" | "lesson" | "compound";
-export type KnowledgeEntryConfidence = "high" | "medium" | "low";
-export type KnowledgeEntrySeverity = "critical" | "important" | "suggestion";
-export type KnowledgeEntrySource = "stage" | "retro" | "compound" | "idea" | "manual";
 export interface KnowledgeEntry {
-    type: KnowledgeEntryType;
-    trigger: string;
-    action: string;
-    confidence: KnowledgeEntryConfidence;
-    severity?: KnowledgeEntrySeverity;
-    stage: FlowStage | null;
-    origin_stage: FlowStage | null;
-    frequency: number;
-    created: string;
-    first_seen_ts: string;
-    last_seen_ts: string;
-    project: string | null;
-    source?: KnowledgeEntrySource | null;
-}
-export interface KnowledgeSeedEntry {
-    type: KnowledgeEntryType;
-    trigger: string;
-    action: string;
-    confidence: KnowledgeEntryConfidence;
-    severity?: KnowledgeEntrySeverity;
-    stage?: FlowStage | null;
-    origin_stage?: FlowStage | null;
-    frequency?: number;
-    created?: string;
-    first_seen_ts?: string;
-    last_seen_ts?: string;
-    project?: string | null;
-    source?: KnowledgeEntrySource | null;
-}
-export interface AppendKnowledgeDefaults {
-    stage?: FlowStage | null;
-    originStage?: FlowStage | null;
-    project?: string | null;
-    source?: KnowledgeEntrySource | null;
-    nowIso?: string;
-}
-export interface AppendKnowledgeResult {
-    appended: number;
-    skippedDuplicates: number;
-    invalid: number;
-    errors: string[];
-    appendedEntries: KnowledgeEntry[];
-}
-export interface ReadKnowledgeOptions {
-    lockAware?: boolean;
-}
-export interface ReadKnowledgeResult {
-    entries: KnowledgeEntry[];
-    malformedLines: number;
-}
-export interface SelectRelevantLearningsOptions {
-    stage?: FlowStage | null;
-    branch?: string | null;
-    diffFiles?: string[];
-    openGates?: string[];
-    limit?: number;
-}
-/**
- * One clustered (trigger, action) group ready for compound lift.
- *
- * A cluster "qualifies" when its recurrence count meets the configured
- * threshold **or** any contributing entry is marked `severity: "critical"`.
- * The skill surface exposes this for nudging — it is not a gate.
- */
-export interface CompoundReadinessCluster {
-    trigger: string;
-    action: string;
-    /**
-     * Sum of `frequency` across entries in the cluster — matches the
-     * recurrence count used by compound readiness analysis.
-     */
-    recurrence: number;
-    /** Distinct entry lines contributing to this cluster. */
-    entryCount: number;
-    qualification: "recurrence" | "critical_override";
-    severity?: KnowledgeEntrySeverity;
-    lastSeenTs: string;
-    /** Entry types observed (rule/pattern/lesson/compound). */
-    types: KnowledgeEntryType[];
-}
-export interface CompoundReadiness {
-    schemaVersion: 2;
-    /**
-     * Effective recurrence threshold actually used. When
-     * `archivedRunsCount < SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD`, this is
-     * `min(baseThreshold, SMALL_PROJECT_RECURRENCE_THRESHOLD)` — otherwise
-     * it equals `baseThreshold`.
-     */
-    threshold: number;
-    /** Base threshold from config/CLI before small-project relaxation. */
-    baseThreshold: number;
-    /**
-     * Archived-run count observed at compute time (used to gate the
-     * small-project relaxation). Optional — the computation can run
-     * without knowing this and then no relaxation is applied.
-     */
-    archivedRunsCount?: number;
-    /**
-     * True iff the effective threshold was lowered by the small-project
-     * relaxation rule. Always false when `archivedRunsCount` is not
-     * supplied.
-     */
-    smallProjectRelaxationApplied: boolean;
-    /** Total number of (trigger, action) clusters seen, regardless of threshold. */
-    clusterCount: number;
-    /** Number of clusters that passed the threshold or critical override. */
-    readyCount: number;
-    /**
-     * Top ready clusters (sorted by qualification severity / recurrence /
-     * recency). Capped by `maxReady` to keep the artifact small.
-     */
-    ready: CompoundReadinessCluster[];
-    lastUpdatedAt: string;
-}
-export interface ComputeCompoundReadinessOptions {
-    threshold?: number;
-    /** Hard cap on `ready[]` to keep the surface digest concise. Default 10. */
-    maxReady?: number;
-    now?: Date;
-    /**
-     * Count of archived runs under `.cclaw/archive/`. When supplied and
-     * `< SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD`, the effective threshold
-     * is lowered to `min(threshold, SMALL_PROJECT_RECURRENCE_THRESHOLD)`.
-     * Matches the rule documented in `docs/config.md`.
-     */
-    archivedRunsCount?: number;
-}
-/**
- * Single source of truth for the small-project relaxation rule.
- *
- * Kept exported so the inline hook mirror and CLI/runtime paths all agree on
- * the same numbers.
- */
-export declare const SMALL_PROJECT_ARCHIVE_RUNS_THRESHOLD = 5;
-export declare const SMALL_PROJECT_RECURRENCE_THRESHOLD = 2;
-export declare function effectiveCompoundThreshold(baseThreshold: number, archivedRunsCount: number | undefined): {
-    threshold: number;
-    relaxationApplied: boolean;
-};
-/**
- * Pure function — no filesystem side effects. Callers pass entries from
- * `readKnowledgeSafely` and get a derived readiness snapshot suitable
- * for persisting to `.cclaw/state/compound-readiness.json`.
- *
- * Clustering key: `(type, normalizeText(trigger), normalizeText(action))`
- * which mirrors the compound readiness clustering in runtime state.
- * The readiness surface intentionally stays simple: no maturity/supersede
- * suppression logic in this pass.
- */
-export declare function computeCompoundReadiness(entries: KnowledgeEntry[], options?: ComputeCompoundReadinessOptions): CompoundReadiness;
-export declare function validateKnowledgeEntry(entry: unknown): {
-    ok: boolean;
-    errors: string[];
-};
-export declare function materializeKnowledgeEntry(seed: KnowledgeSeedEntry, defaults?: AppendKnowledgeDefaults): KnowledgeEntry;
-export declare function readKnowledgeSafely(projectRoot: string, options?: ReadKnowledgeOptions): Promise<ReadKnowledgeResult>;
-export declare function appendKnowledge(projectRoot: string, seeds: KnowledgeSeedEntry[], defaults?: AppendKnowledgeDefaults): Promise<AppendKnowledgeResult>;
-export declare function selectRelevantLearnings(projectRoot: string, options?: SelectRelevantLearningsOptions): Promise<KnowledgeEntry[]>;
+    slug: string;
+    ship_commit: string;
+    shipped_at: string;
+    signals: {
+        hasArchitectDecision: boolean;
+        reviewIterations: number;
+        securityFlag: boolean;
+        userRequestedCapture: boolean;
+    };
+    refines?: string | null;
+    notes?: string;
+    tags?: string[];
+}
+export declare class KnowledgeStoreError extends Error {
+}
+export declare function knowledgeLogPath(projectRoot: string): string;
+export declare function appendKnowledgeEntry(projectRoot: string, entry: KnowledgeEntry): Promise<void>;
+export declare function readKnowledgeLog(projectRoot: string): Promise<KnowledgeEntry[]>;
+export declare function findRefiningChain(projectRoot: string, slug: string): Promise<KnowledgeEntry[]>;