@arcbridge/core 0.6.1 → 0.6.2

package/dist/index.d.ts

@@ -779,9 +779,24 @@ interface GenerateDatabaseResult {
     db: Database;
     warnings: string[];
 }
+/**
+ * Thrown when a top-level source file exists but fails parsing or schema
+ * validation during populate/refresh. Aborting (instead of warning) lets the
+ * surrounding transaction roll back, so the database keeps its previous
+ * state rather than committing with the corresponding tables wiped.
+ */
+declare class RefreshValidationError extends Error {
+    readonly file: string;
+    constructor(file: string, detail: string);
+}
 /**
  * Re-read arc42 files from disk and update the database.
  * Uses INSERT OR REPLACE to pick up changes made since initial generation.
+ *
+ * Throws RefreshValidationError (rolling back the transaction, leaving the
+ * database unchanged) when a top-level source file exists but is malformed:
+ * 05-building-blocks.md, 10-quality-scenarios.yaml, or phases.yaml.
+ * Missing files and invalid individual task/ADR files only produce warnings.
  */
 declare function refreshFromDocs(db: Database, targetDir: string): string[];
 declare function generateDatabase(targetDir: string, input: InitProjectInput): GenerateDatabaseResult;
@@ -1167,4 +1182,25 @@ declare function loadConfig(projectRoot: string): {
     error: string | null;
 };
 
-export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QUALITY_PRIORITIES_DESCRIPTION, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addPhaseToYaml, addTaskToYaml, applyInferences, deletePhaseFromYaml, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };
+/**
+ * Write a file atomically: write to a temp file in the same directory,
+ * then rename over the target. A crash or full disk mid-write leaves the
+ * original file untouched instead of truncated or half-written.
+ *
+ * Matches writeFileSync semantics that a bare rename would break:
+ * - symlinks are resolved first, so the rename replaces the link's target,
+ *   not the link itself
+ * - an existing target's permission bits are preserved
+ *
+ * The temp file lives next to the resolved target — rename is only atomic
+ * within a filesystem.
+ */
+declare function atomicWriteFileSync(filePath: string, content: string): void;
+
+/**
+ * Log a non-fatal warning to stderr. stdout is reserved for command output
+ * (--json) and MCP stdio framing, so diagnostics must go to stderr.
+ */
+declare function logWarn(context: string, err?: unknown): void;
+
+export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QUALITY_PRIORITIES_DESCRIPTION, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, RefreshValidationError, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addPhaseToYaml, addTaskToYaml, applyInferences, atomicWriteFileSync, deletePhaseFromYaml, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, logWarn, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };