@harness-forge/cli 0.1.0

package/dist/infrastructure/observability/local-metrics-store.d.ts

@@ -0,0 +1,18 @@
+export interface EffectivenessSignalRecord {
+    signalType: string;
+    subjectId: string;
+    context?: string;
+    result: "success" | "skipped" | "failed" | "accepted" | "rejected";
+    recordedAt: string;
+    details?: Record<string, unknown>;
+}
+export interface EffectivenessSummary {
+    total: number;
+    bySignalType: Record<string, number>;
+    byResult: Record<string, number>;
+    latest?: EffectivenessSignalRecord;
+}
+export declare function readEffectivenessSignals(root: string): Promise<EffectivenessSignalRecord[]>;
+export declare function appendEffectivenessSignal(root: string, signal: EffectivenessSignalRecord): Promise<void>;
+export declare function summarizeEffectivenessSignals(root: string): Promise<EffectivenessSummary>;
+//# sourceMappingURL=local-metrics-store.d.ts.map

package/dist/infrastructure/observability/local-metrics-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-metrics-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/observability/local-metrics-store.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAMD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAOjG;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9G;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgB/F"}

package/dist/infrastructure/observability/local-metrics-store.js

@@ -0,0 +1,35 @@
+import path from "node:path";
+import { EFFECTIVENESS_FILE, ensureDir, exists, OBSERVABILITY_DIR, readJsonFile, writeJsonFile } from "../../shared/index.js";
+function metricsPath(root) {
+    return path.join(root, OBSERVABILITY_DIR, EFFECTIVENESS_FILE);
+}
+export async function readEffectivenessSignals(root) {
+    const targetPath = metricsPath(root);
+    if (!(await exists(targetPath))) {
+        return [];
+    }
+    return readJsonFile(targetPath);
+}
+export async function appendEffectivenessSignal(root, signal) {
+    const targetDir = path.join(root, OBSERVABILITY_DIR);
+    await ensureDir(targetDir);
+    const signals = await readEffectivenessSignals(root);
+    signals.push(signal);
+    await writeJsonFile(metricsPath(root), signals);
+}
+export async function summarizeEffectivenessSignals(root) {
+    const signals = await readEffectivenessSignals(root);
+    const bySignalType = {};
+    const byResult = {};
+    for (const signal of signals) {
+        bySignalType[signal.signalType] = (bySignalType[signal.signalType] ?? 0) + 1;
+        byResult[signal.result] = (byResult[signal.result] ?? 0) + 1;
+    }
+    return {
+        total: signals.length,
+        bySignalType,
+        byResult,
+        latest: signals[signals.length - 1]
+    };
+}
+//# sourceMappingURL=local-metrics-store.js.map

package/dist/infrastructure/observability/local-metrics-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-metrics-store.js","sourceRoot":"","sources":["../../../src/infrastructure/observability/local-metrics-store.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AAkB/B,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACzD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAA8B,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAY,EAAE,MAAiC;IAC7F,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,IAAY;IAC9D,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7E,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,YAAY;QACZ,QAAQ;QACR,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/infrastructure/recursive/session-store.d.ts

@@ -0,0 +1,45 @@
+import type { RecursiveSession } from "../../domain/recursive/session.js";
+import type { RecursiveSessionSummary } from "../../domain/recursive/session-summary.js";
+export interface RecursiveWorkingMemoryRecord {
+    sessionId: string;
+    taskId?: string;
+    currentObjective: string;
+    currentPlan: string[];
+    filesInFocus: string[];
+    confirmedFacts: string[];
+    inferredFacts: string[];
+    blockers: string[];
+    openQuestions: string[];
+    recentFailedAttempts: string[];
+    nextStep: string;
+    lastUpdated: string;
+}
+export interface RecursiveScratchRecord {
+    sessionId: string;
+    updatedAt: string;
+    notes: string[];
+}
+export interface RecursiveSessionBundle {
+    session: RecursiveSession;
+    memory: RecursiveWorkingMemoryRecord;
+    scratch: RecursiveScratchRecord;
+    calls: Array<Record<string, unknown>>;
+    summary: RecursiveSessionSummary;
+    finalOutput?: Record<string, unknown>;
+}
+export declare function resolveRecursiveSessionPaths(workspaceRoot: string, sessionId: string): {
+    sessionsDir: string;
+    sessionDir: string;
+    sessionPath: string;
+    memoryPath: string;
+    scratchPath: string;
+    callsPath: string;
+    tracePath: string;
+    summaryPath: string;
+    finalOutputPath: string;
+};
+export declare function writeRecursiveSessionBundle(workspaceRoot: string, bundle: RecursiveSessionBundle): Promise<ReturnType<typeof resolveRecursiveSessionPaths>>;
+export declare function loadRecursiveSession(workspaceRoot: string, sessionId: string): Promise<RecursiveSession | null>;
+export declare function loadRecursiveSessionSummary(workspaceRoot: string, sessionId: string): Promise<RecursiveSessionSummary | null>;
+export declare function listRecursiveSessionIds(workspaceRoot: string): Promise<string[]>;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/infrastructure/recursive/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/recursive/session-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAoBzF,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,4BAA4B,CAAC;IACrC,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,uBAAuB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAMD,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,CAcA;AAED,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAY1D;AAED,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAMrH;AAED,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAMzC;AAED,wBAAsB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWtF"}

package/dist/infrastructure/recursive/session-store.js

@@ -0,0 +1,62 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parseRecursiveSession } from "../../domain/recursive/session.js";
+import { parseRecursiveSessionSummary } from "../../domain/recursive/session-summary.js";
+import { RUNTIME_DIR, RUNTIME_RECURSIVE_CALLS_FILE, RUNTIME_RECURSIVE_DIR, RUNTIME_RECURSIVE_FINAL_OUTPUT_FILE, RUNTIME_RECURSIVE_MEMORY_FILE, RUNTIME_RECURSIVE_SCRATCH_FILE, RUNTIME_RECURSIVE_SESSIONS_DIR, RUNTIME_RECURSIVE_SESSION_FILE, RUNTIME_RECURSIVE_SUMMARY_FILE, RUNTIME_RECURSIVE_TRACE_FILE, ensureDir, exists, readJsonFile, writeJsonFile } from "../../shared/index.js";
+function recursiveSessionsRoot(workspaceRoot) {
+    return path.join(workspaceRoot, RUNTIME_DIR, RUNTIME_RECURSIVE_DIR, RUNTIME_RECURSIVE_SESSIONS_DIR);
+}
+export function resolveRecursiveSessionPaths(workspaceRoot, sessionId) {
+    const sessionsDir = recursiveSessionsRoot(workspaceRoot);
+    const sessionDir = path.join(sessionsDir, sessionId);
+    return {
+        sessionsDir,
+        sessionDir,
+        sessionPath: path.join(sessionDir, RUNTIME_RECURSIVE_SESSION_FILE),
+        memoryPath: path.join(sessionDir, RUNTIME_RECURSIVE_MEMORY_FILE),
+        scratchPath: path.join(sessionDir, RUNTIME_RECURSIVE_SCRATCH_FILE),
+        callsPath: path.join(sessionDir, RUNTIME_RECURSIVE_CALLS_FILE),
+        tracePath: path.join(sessionDir, RUNTIME_RECURSIVE_TRACE_FILE),
+        summaryPath: path.join(sessionDir, RUNTIME_RECURSIVE_SUMMARY_FILE),
+        finalOutputPath: path.join(sessionDir, RUNTIME_RECURSIVE_FINAL_OUTPUT_FILE)
+    };
+}
+export async function writeRecursiveSessionBundle(workspaceRoot, bundle) {
+    const paths = resolveRecursiveSessionPaths(workspaceRoot, bundle.session.sessionId);
+    await ensureDir(paths.sessionDir);
+    await Promise.all([
+        writeJsonFile(paths.sessionPath, bundle.session),
+        writeJsonFile(paths.memoryPath, bundle.memory),
+        writeJsonFile(paths.scratchPath, bundle.scratch),
+        writeJsonFile(paths.callsPath, bundle.calls),
+        writeJsonFile(paths.summaryPath, bundle.summary),
+        ...(bundle.finalOutput ? [writeJsonFile(paths.finalOutputPath, bundle.finalOutput)] : [])
+    ]);
+    return paths;
+}
+export async function loadRecursiveSession(workspaceRoot, sessionId) {
+    const { sessionPath } = resolveRecursiveSessionPaths(workspaceRoot, sessionId);
+    if (!(await exists(sessionPath))) {
+        return null;
+    }
+    return parseRecursiveSession(await readJsonFile(sessionPath));
+}
+export async function loadRecursiveSessionSummary(workspaceRoot, sessionId) {
+    const { summaryPath } = resolveRecursiveSessionPaths(workspaceRoot, sessionId);
+    if (!(await exists(summaryPath))) {
+        return null;
+    }
+    return parseRecursiveSessionSummary(await readJsonFile(summaryPath));
+}
+export async function listRecursiveSessionIds(workspaceRoot) {
+    const sessionsDir = recursiveSessionsRoot(workspaceRoot);
+    if (!(await exists(sessionsDir))) {
+        return [];
+    }
+    const entries = await fs.readdir(sessionsDir, { withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+}
+//# sourceMappingURL=session-store.js.map

package/dist/infrastructure/recursive/session-store.js.map

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

package/dist/infrastructure/recursive/template-loader.d.ts

@@ -0,0 +1,3 @@
+import type { RecursiveTemplateRegistry } from "../../domain/recursive/template-registry.js";
+export declare function loadRecursiveTemplateRegistry(workspaceRoot: string): Promise<RecursiveTemplateRegistry>;
+//# sourceMappingURL=template-loader.d.ts.map

package/dist/infrastructure/recursive/template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/recursive/template-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAI7F,wBAAsB,6BAA6B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAgB7G"}

package/dist/infrastructure/recursive/template-loader.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+import { parseRecursiveTemplateRegistry } from "../../domain/recursive/template-registry.js";
+import { AI_TEMPLATES_DIR, PACKAGE_ROOT, exists, readJsonFile } from "../../shared/index.js";
+export async function loadRecursiveTemplateRegistry(workspaceRoot) {
+    const candidates = [
+        path.join(workspaceRoot, AI_TEMPLATES_DIR, "recursive", "registry.json"),
+        path.join(PACKAGE_ROOT, "templates", "recursive", "registry.json")
+    ];
+    for (const candidate of candidates) {
+        if (await exists(candidate)) {
+            return parseRecursiveTemplateRegistry(await readJsonFile(candidate));
+        }
+    }
+    return {
+        version: 1,
+        entries: []
+    };
+}
+//# sourceMappingURL=template-loader.js.map

package/dist/infrastructure/recursive/template-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.js","sourceRoot":"","sources":["../../../src/infrastructure/recursive/template-loader.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7F,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,aAAqB;IACvE,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,CAAC;QACxE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,CAAC;KACnE,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,8BAA8B,CAAC,MAAM,YAAY,CAA4B,SAAS,CAAC,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC"}

package/dist/infrastructure/recursive/trace-logger.d.ts

@@ -0,0 +1,3 @@
+import type { RecursiveTraceEvent } from "../../domain/recursive/trace-event.js";
+export declare function appendRecursiveTraceEvent(tracePath: string, event: RecursiveTraceEvent): Promise<void>;
+//# sourceMappingURL=trace-logger.d.ts.map

package/dist/infrastructure/recursive/trace-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-logger.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/recursive/trace-logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5G"}

package/dist/infrastructure/recursive/trace-logger.js

@@ -0,0 +1,8 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureDir } from "../../shared/index.js";
+export async function appendRecursiveTraceEvent(tracePath, event) {
+    await ensureDir(path.dirname(tracePath));
+    await fs.appendFile(tracePath, `${JSON.stringify(event)}\n`, "utf8");
+}
+//# sourceMappingURL=trace-logger.js.map

package/dist/infrastructure/recursive/trace-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-logger.js","sourceRoot":"","sources":["../../../src/infrastructure/recursive/trace-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,SAAiB,EAAE,KAA0B;IAC3F,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/shared/constants.d.ts

@@ -0,0 +1,97 @@
+export declare const STATE_DIR = ".hforge/state";
+export declare const AI_LAYER_ROOT_DIR = ".hforge";
+export declare const AI_LAYER_LIBRARY_DIR = ".hforge/library";
+export declare const AI_LAYER_VISIBLE_MODE = "hidden-ai-layer";
+export declare const AI_LIBRARY_AGENTS_DIR = ".hforge/library/agents";
+export declare const AI_LIBRARY_COMMANDS_DIR = ".hforge/library/commands";
+export declare const AI_LIBRARY_CONTEXTS_DIR = ".hforge/library/contexts";
+export declare const AI_LIBRARY_DOCS_DIR = ".hforge/library/docs";
+export declare const AI_LIBRARY_HOOKS_DIR = ".hforge/library/hooks";
+export declare const AI_LIBRARY_KNOWLEDGE_DIR = ".hforge/library/knowledge";
+export declare const AI_LIBRARY_MANIFESTS_DIR = ".hforge/library/manifests";
+export declare const AI_LIBRARY_MCP_DIR = ".hforge/library/mcp";
+export declare const AI_LIBRARY_PROFILES_DIR = ".hforge/library/profiles";
+export declare const AI_LIBRARY_RULES_DIR = ".hforge/library/rules";
+export declare const AI_LIBRARY_SCRIPTS_DIR = ".hforge/library/scripts";
+export declare const AI_LIBRARY_SCHEMAS_DIR = ".hforge/library/schemas";
+export declare const AI_LIBRARY_SKILLS_DIR = ".hforge/library/skills";
+export declare const AI_LIBRARY_TARGETS_DIR = ".hforge/library/targets";
+export declare const AI_TEMPLATES_DIR = ".hforge/templates";
+export declare const RUNTIME_DIR = ".hforge/runtime";
+export declare const AGENT_MANIFEST_FILE = ".hforge/agent-manifest.json";
+export declare const RUNTIME_SCHEMA_VERSION = 3;
+export declare const RUNTIME_INDEX_FILE = "index.json";
+export declare const RUNTIME_README_FILE = "README.md";
+export declare const RUNTIME_REPO_DIR = "repo";
+export declare const RUNTIME_FINDINGS_DIR = "findings";
+export declare const RUNTIME_TASKS_DIR = "tasks";
+export declare const RUNTIME_TEMPLATES_DIR = "templates";
+export declare const RUNTIME_DECISIONS_DIR = "decisions";
+export declare const RUNTIME_CACHE_DIR = "cache";
+export declare const RUNTIME_RECURSIVE_DIR = "recursive";
+export declare const RUNTIME_RECURSIVE_SESSIONS_DIR = "sessions";
+export declare const RUNTIME_REPO_MAP_FILE = "repo-map.json";
+export declare const RUNTIME_RECOMMENDATIONS_FILE = "recommendations.json";
+export declare const RUNTIME_TARGET_SUPPORT_FILE = "target-support.json";
+export declare const RUNTIME_INSTRUCTION_PLAN_FILE = "instruction-plan.json";
+export declare const RUNTIME_SCAN_SUMMARY_FILE = "scan-summary.json";
+export declare const RUNTIME_VALIDATION_GAPS_FILE = "validation-gaps.json";
+export declare const RUNTIME_RISK_SIGNALS_FILE = "risk-signals.json";
+export declare const RUNTIME_FILE_INTEREST_FILE = "file-interest.json";
+export declare const RUNTIME_IMPACT_ANALYSIS_FILE = "impact-analysis.json";
+export declare const RUNTIME_TASK_PACK_FILE = "task-pack.json";
+export declare const RUNTIME_WORKING_MEMORY_FILE = "working-memory.json";
+export declare const RUNTIME_TASK_RECURSIVE_LINK_FILE = "recursive-session.json";
+export declare const RUNTIME_RUNTIME_TEMPLATE_REGISTRY_FILE = "registry.json";
+export declare const RUNTIME_DECISION_INDEX_FILE = "index.json";
+export declare const RUNTIME_DECISION_COVERAGE_SUMMARY_FILE = "coverage-summary.json";
+export declare const RUNTIME_RECURSIVE_SESSION_FILE = "session.json";
+export declare const RUNTIME_RECURSIVE_MEMORY_FILE = "memory.json";
+export declare const RUNTIME_RECURSIVE_SCRATCH_FILE = "scratch.json";
+export declare const RUNTIME_RECURSIVE_CALLS_FILE = "calls.json";
+export declare const RUNTIME_RECURSIVE_TRACE_FILE = "trace.jsonl";
+export declare const RUNTIME_RECURSIVE_SUMMARY_FILE = "summary.json";
+export declare const RUNTIME_RECURSIVE_FINAL_OUTPUT_FILE = "final-output.json";
+export declare const INSTALL_STATE_FILE = "install-state.json";
+export declare const OBSERVABILITY_DIR = ".hforge/observability";
+export declare const EFFECTIVENESS_FILE = "effectiveness-signals.json";
+export declare const GENERATED_DIR = ".hforge/generated";
+export declare const OBSERVABILITY_EVENTS_FILE = "events.json";
+export declare const OBSERVABILITY_SUMMARY_FILE = "summary.json";
+export declare const SPECIFY_STATE_DIR = ".specify/state";
+export declare const FLOW_STATE_FILE = "flow-state.json";
+export declare const DEFAULT_BUNDLE_MANIFEST = "manifests/catalog/index.json";
+export declare const CAPABILITY_TAXONOMY_FILE = "manifests/catalog/capability-taxonomy.json";
+export declare const HARNESS_CAPABILITY_MATRIX_FILE = "manifests/catalog/harness-capability-matrix.json";
+export declare const ENGINEERING_ASSISTANT_IMPORT_INVENTORY_FILE = "manifests/catalog/engineering-assistant-import-inventory.json";
+export declare const ENGINEERING_ASSISTANT_PORT_PROVENANCE_FILE = "docs/authoring/engineering-assistant-port.md";
+export declare const ENHANCED_SKILL_IMPORT_INVENTORY_FILE = "manifests/catalog/enhanced-skill-import-inventory.json";
+export declare const ENHANCED_SKILL_IMPORT_PROVENANCE_FILE = "docs/authoring/enhanced-skill-import.md";
+export declare const REPO_MAP_SCHEMA_FILE = "schemas/runtime/repo-map.schema.json";
+export declare const INSTRUCTION_PLAN_SCHEMA_FILE = "schemas/runtime/instruction-plan.schema.json";
+export declare const OBSERVABILITY_EVENT_SCHEMA_FILE = "schemas/runtime/observability-event.schema.json";
+export declare const OBSERVABILITY_SUMMARY_SCHEMA_FILE = "schemas/runtime/observability-summary.schema.json";
+export declare const BENCHMARK_EXPECTATION_SCHEMA_FILE = "schemas/runtime/benchmark-expectation.schema.json";
+export declare const WORKTREE_PLAN_SCHEMA_FILE = "schemas/runtime/worktree-plan.schema.json";
+export declare const WORKTREE_STATE_SCHEMA_FILE = "schemas/runtime/worktree-state.schema.json";
+export declare const FILE_INTEREST_SCHEMA_FILE = "schemas/runtime/file-interest.schema.json";
+export declare const IMPACT_ANALYSIS_SCHEMA_FILE = "schemas/runtime/impact-analysis.schema.json";
+export declare const TASK_PACK_SCHEMA_FILE = "schemas/runtime/task-pack.schema.json";
+export declare const WORKING_MEMORY_SCHEMA_FILE = "schemas/runtime/working-memory.schema.json";
+export declare const ARCHITECTURE_SIGNIFICANCE_SCHEMA_FILE = "schemas/runtime/architecture-significance.schema.json";
+export declare const DECISION_RECORD_SCHEMA_FILE = "schemas/runtime/decision-record.schema.json";
+export declare const DECISION_COVERAGE_SUMMARY_SCHEMA_FILE = "schemas/runtime/decision-coverage-summary.schema.json";
+export declare const RECURSIVE_SESSION_SCHEMA_FILE = "schemas/runtime/recursive-session.schema.json";
+export declare const RECURSIVE_BUDGET_SCHEMA_FILE = "schemas/runtime/recursive-budget.schema.json";
+export declare const RECURSIVE_TRACE_EVENT_SCHEMA_FILE = "schemas/runtime/recursive-trace-event.schema.json";
+export declare const RECURSIVE_SESSION_SUMMARY_SCHEMA_FILE = "schemas/runtime/recursive-session-summary.schema.json";
+export declare const RECURSIVE_ADR_CANDIDATE_SCHEMA_FILE = "schemas/runtime/recursive-adr-candidate.schema.json";
+export declare const RECURSIVE_TEMPLATE_REGISTRY_SCHEMA_FILE = "schemas/templates/recursive-template-registry.schema.json";
+export declare const RUNTIME_TEMPLATE_REGISTRY_SCHEMA_FILE = "schemas/templates/runtime-template-registry.schema.json";
+export declare const TEMPLATE_REQUIRED_SECTIONS = "scripts/templates/config/required-sections.json";
+export declare const AUTHORITATIVE_AI_LAYER_SURFACES: readonly [".hforge/library/skills", ".hforge/library/rules", ".hforge/library/knowledge", ".hforge/templates", ".hforge/runtime", "tasks", "cache", ".hforge/state", ".hforge/generated"];
+export declare const VISIBLE_BRIDGE_SURFACES: readonly ["AGENTS.md", "CLAUDE.md", ".agents/skills", ".specify", ".codex", ".claude"];
+export declare const PACKAGE_ROOT: string;
+export declare const REPO_ROOT: string;
+export declare const DEFAULT_WORKSPACE_ROOT: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

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

package/dist/shared/constants.js

@@ -0,0 +1,111 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export const STATE_DIR = ".hforge/state";
+export const AI_LAYER_ROOT_DIR = ".hforge";
+export const AI_LAYER_LIBRARY_DIR = ".hforge/library";
+export const AI_LAYER_VISIBLE_MODE = "hidden-ai-layer";
+export const AI_LIBRARY_AGENTS_DIR = ".hforge/library/agents";
+export const AI_LIBRARY_COMMANDS_DIR = ".hforge/library/commands";
+export const AI_LIBRARY_CONTEXTS_DIR = ".hforge/library/contexts";
+export const AI_LIBRARY_DOCS_DIR = ".hforge/library/docs";
+export const AI_LIBRARY_HOOKS_DIR = ".hforge/library/hooks";
+export const AI_LIBRARY_KNOWLEDGE_DIR = ".hforge/library/knowledge";
+export const AI_LIBRARY_MANIFESTS_DIR = ".hforge/library/manifests";
+export const AI_LIBRARY_MCP_DIR = ".hforge/library/mcp";
+export const AI_LIBRARY_PROFILES_DIR = ".hforge/library/profiles";
+export const AI_LIBRARY_RULES_DIR = ".hforge/library/rules";
+export const AI_LIBRARY_SCRIPTS_DIR = ".hforge/library/scripts";
+export const AI_LIBRARY_SCHEMAS_DIR = ".hforge/library/schemas";
+export const AI_LIBRARY_SKILLS_DIR = ".hforge/library/skills";
+export const AI_LIBRARY_TARGETS_DIR = ".hforge/library/targets";
+export const AI_TEMPLATES_DIR = ".hforge/templates";
+export const RUNTIME_DIR = ".hforge/runtime";
+export const AGENT_MANIFEST_FILE = ".hforge/agent-manifest.json";
+export const RUNTIME_SCHEMA_VERSION = 3;
+export const RUNTIME_INDEX_FILE = "index.json";
+export const RUNTIME_README_FILE = "README.md";
+export const RUNTIME_REPO_DIR = "repo";
+export const RUNTIME_FINDINGS_DIR = "findings";
+export const RUNTIME_TASKS_DIR = "tasks";
+export const RUNTIME_TEMPLATES_DIR = "templates";
+export const RUNTIME_DECISIONS_DIR = "decisions";
+export const RUNTIME_CACHE_DIR = "cache";
+export const RUNTIME_RECURSIVE_DIR = "recursive";
+export const RUNTIME_RECURSIVE_SESSIONS_DIR = "sessions";
+export const RUNTIME_REPO_MAP_FILE = "repo-map.json";
+export const RUNTIME_RECOMMENDATIONS_FILE = "recommendations.json";
+export const RUNTIME_TARGET_SUPPORT_FILE = "target-support.json";
+export const RUNTIME_INSTRUCTION_PLAN_FILE = "instruction-plan.json";
+export const RUNTIME_SCAN_SUMMARY_FILE = "scan-summary.json";
+export const RUNTIME_VALIDATION_GAPS_FILE = "validation-gaps.json";
+export const RUNTIME_RISK_SIGNALS_FILE = "risk-signals.json";
+export const RUNTIME_FILE_INTEREST_FILE = "file-interest.json";
+export const RUNTIME_IMPACT_ANALYSIS_FILE = "impact-analysis.json";
+export const RUNTIME_TASK_PACK_FILE = "task-pack.json";
+export const RUNTIME_WORKING_MEMORY_FILE = "working-memory.json";
+export const RUNTIME_TASK_RECURSIVE_LINK_FILE = "recursive-session.json";
+export const RUNTIME_RUNTIME_TEMPLATE_REGISTRY_FILE = "registry.json";
+export const RUNTIME_DECISION_INDEX_FILE = "index.json";
+export const RUNTIME_DECISION_COVERAGE_SUMMARY_FILE = "coverage-summary.json";
+export const RUNTIME_RECURSIVE_SESSION_FILE = "session.json";
+export const RUNTIME_RECURSIVE_MEMORY_FILE = "memory.json";
+export const RUNTIME_RECURSIVE_SCRATCH_FILE = "scratch.json";
+export const RUNTIME_RECURSIVE_CALLS_FILE = "calls.json";
+export const RUNTIME_RECURSIVE_TRACE_FILE = "trace.jsonl";
+export const RUNTIME_RECURSIVE_SUMMARY_FILE = "summary.json";
+export const RUNTIME_RECURSIVE_FINAL_OUTPUT_FILE = "final-output.json";
+export const INSTALL_STATE_FILE = "install-state.json";
+export const OBSERVABILITY_DIR = ".hforge/observability";
+export const EFFECTIVENESS_FILE = "effectiveness-signals.json";
+export const GENERATED_DIR = ".hforge/generated";
+export const OBSERVABILITY_EVENTS_FILE = "events.json";
+export const OBSERVABILITY_SUMMARY_FILE = "summary.json";
+export const SPECIFY_STATE_DIR = ".specify/state";
+export const FLOW_STATE_FILE = "flow-state.json";
+export const DEFAULT_BUNDLE_MANIFEST = "manifests/catalog/index.json";
+export const CAPABILITY_TAXONOMY_FILE = "manifests/catalog/capability-taxonomy.json";
+export const HARNESS_CAPABILITY_MATRIX_FILE = "manifests/catalog/harness-capability-matrix.json";
+export const ENGINEERING_ASSISTANT_IMPORT_INVENTORY_FILE = "manifests/catalog/engineering-assistant-import-inventory.json";
+export const ENGINEERING_ASSISTANT_PORT_PROVENANCE_FILE = "docs/authoring/engineering-assistant-port.md";
+export const ENHANCED_SKILL_IMPORT_INVENTORY_FILE = "manifests/catalog/enhanced-skill-import-inventory.json";
+export const ENHANCED_SKILL_IMPORT_PROVENANCE_FILE = "docs/authoring/enhanced-skill-import.md";
+export const REPO_MAP_SCHEMA_FILE = "schemas/runtime/repo-map.schema.json";
+export const INSTRUCTION_PLAN_SCHEMA_FILE = "schemas/runtime/instruction-plan.schema.json";
+export const OBSERVABILITY_EVENT_SCHEMA_FILE = "schemas/runtime/observability-event.schema.json";
+export const OBSERVABILITY_SUMMARY_SCHEMA_FILE = "schemas/runtime/observability-summary.schema.json";
+export const BENCHMARK_EXPECTATION_SCHEMA_FILE = "schemas/runtime/benchmark-expectation.schema.json";
+export const WORKTREE_PLAN_SCHEMA_FILE = "schemas/runtime/worktree-plan.schema.json";
+export const WORKTREE_STATE_SCHEMA_FILE = "schemas/runtime/worktree-state.schema.json";
+export const FILE_INTEREST_SCHEMA_FILE = "schemas/runtime/file-interest.schema.json";
+export const IMPACT_ANALYSIS_SCHEMA_FILE = "schemas/runtime/impact-analysis.schema.json";
+export const TASK_PACK_SCHEMA_FILE = "schemas/runtime/task-pack.schema.json";
+export const WORKING_MEMORY_SCHEMA_FILE = "schemas/runtime/working-memory.schema.json";
+export const ARCHITECTURE_SIGNIFICANCE_SCHEMA_FILE = "schemas/runtime/architecture-significance.schema.json";
+export const DECISION_RECORD_SCHEMA_FILE = "schemas/runtime/decision-record.schema.json";
+export const DECISION_COVERAGE_SUMMARY_SCHEMA_FILE = "schemas/runtime/decision-coverage-summary.schema.json";
+export const RECURSIVE_SESSION_SCHEMA_FILE = "schemas/runtime/recursive-session.schema.json";
+export const RECURSIVE_BUDGET_SCHEMA_FILE = "schemas/runtime/recursive-budget.schema.json";
+export const RECURSIVE_TRACE_EVENT_SCHEMA_FILE = "schemas/runtime/recursive-trace-event.schema.json";
+export const RECURSIVE_SESSION_SUMMARY_SCHEMA_FILE = "schemas/runtime/recursive-session-summary.schema.json";
+export const RECURSIVE_ADR_CANDIDATE_SCHEMA_FILE = "schemas/runtime/recursive-adr-candidate.schema.json";
+export const RECURSIVE_TEMPLATE_REGISTRY_SCHEMA_FILE = "schemas/templates/recursive-template-registry.schema.json";
+export const RUNTIME_TEMPLATE_REGISTRY_SCHEMA_FILE = "schemas/templates/runtime-template-registry.schema.json";
+export const TEMPLATE_REQUIRED_SECTIONS = "scripts/templates/config/required-sections.json";
+export const AUTHORITATIVE_AI_LAYER_SURFACES = [
+    AI_LIBRARY_SKILLS_DIR,
+    AI_LIBRARY_RULES_DIR,
+    AI_LIBRARY_KNOWLEDGE_DIR,
+    AI_TEMPLATES_DIR,
+    RUNTIME_DIR,
+    RUNTIME_TASKS_DIR,
+    RUNTIME_CACHE_DIR,
+    STATE_DIR,
+    GENERATED_DIR
+];
+export const VISIBLE_BRIDGE_SURFACES = ["AGENTS.md", "CLAUDE.md", ".agents/skills", ".specify", ".codex", ".claude"];
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export const PACKAGE_ROOT = path.resolve(__dirname, "..", "..");
+export const REPO_ROOT = PACKAGE_ROOT;
+export const DEFAULT_WORKSPACE_ROOT = process.cwd();
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class HarnessForgeError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare class ValidationError extends HarnessForgeError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IACb,QAAQ,CAAC,IAAI;gBAA9B,OAAO,EAAE,MAAM,EAAW,IAAI,SAAwB;CAInE;AAED,qBAAa,eAAgB,SAAQ,iBAAiB;gBACxC,OAAO,EAAE,MAAM;CAG5B"}

package/dist/shared/errors.js

@@ -0,0 +1,14 @@
+export class HarnessForgeError extends Error {
+    code;
+    constructor(message, code = "HARNESS_FORGE_ERROR") {
+        super(message);
+        this.code = code;
+        this.name = "HarnessForgeError";
+    }
+}
+export class ValidationError extends HarnessForgeError {
+    constructor(message) {
+        super(message, "VALIDATION_ERROR");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACJ;IAAtC,YAAY,OAAe,EAAW,OAAO,qBAAqB;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAwB;QAEhE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/shared/fs.d.ts

@@ -0,0 +1,8 @@
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function exists(filePath: string): Promise<boolean>;
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+export declare function appendJsonArrayItem<T>(filePath: string, value: T): Promise<void>;
+export declare function readTextFile(filePath: string): Promise<string>;
+export declare function writeTextFile(filePath: string, value: string): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/shared/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/shared/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGlE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF"}

package/dist/shared/fs.js

@@ -0,0 +1,35 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+export async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readJsonFile(filePath) {
+    const content = await fs.readFile(filePath, "utf8");
+    return JSON.parse(content);
+}
+export async function writeJsonFile(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+export async function appendJsonArrayItem(filePath, value) {
+    const existing = (await exists(filePath)) ? await readJsonFile(filePath) : [];
+    existing.push(value);
+    await writeJsonFile(filePath, existing);
+}
+export async function readTextFile(filePath) {
+    return fs.readFile(filePath, "utf8");
+}
+export async function writeTextFile(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, value, "utf8");
+}
+//# sourceMappingURL=fs.js.map

package/dist/shared/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/shared/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAClE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAI,QAAgB,EAAE,KAAQ;IACrE,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,YAAY,CAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAa;IACjE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./constants.js";
+export * from "./errors.js";
+export * from "./fs.js";
+export * from "./seeded-knowledge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,5 @@
+export * from "./constants.js";
+export * from "./errors.js";
+export * from "./fs.js";
+export * from "./seeded-knowledge.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":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,uBAAuB,CAAC"}

package/dist/shared/seeded-knowledge.d.ts

@@ -0,0 +1,8 @@
+export declare const SEEDED_LANGUAGE_IDS: readonly ["typescript", "java", "dotnet", "lua", "powershell"];
+export type SeededLanguageId = (typeof SEEDED_LANGUAGE_IDS)[number];
+export type SeededContentKind = "root-doc" | "metadata" | "overview" | "review-checklist" | "examples-guide" | "framework-notes" | "example" | "common-rule" | "language-rule" | "legacy-seed";
+export declare function isSeededLanguageId(value: string): value is SeededLanguageId;
+export declare function getSeededArchiveDirectory(language: SeededLanguageId): string;
+export declare function getSeededArchivePath(language: SeededLanguageId, relativePath: string): string;
+export declare function classifySeededRelativePath(relativePath: string): SeededContentKind;
+//# sourceMappingURL=seeded-knowledge.d.ts.map

package/dist/shared/seeded-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeded-knowledge.d.ts","sourceRoot":"","sources":["../../src/shared/seeded-knowledge.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,gEAAiE,CAAC;AAElG,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAUpE,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,UAAU,GACV,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,GACT,aAAa,GACb,eAAe,GACf,aAAa,CAAC;AAElB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAwClF"}