@warpgogol/forge 4.1.3 → 4.1.4

package/os/mission/handlers/archive.test.ts

@@ -131,6 +131,60 @@ describe("mission.archive", () => {
     expect(existsSync(path.join(missionsDir, "archive", "closed", "test-m006"))).toBe(false);
   });
 
+  test("closed mission without releaseId → warns in pretty mode", async () => {
+    await writeMissionManifest(missionsDir, "test-m007", "closed");
+    const warnSpy = vi.fn();
+    const ctx: ForgeRuntimeContext = {
+      workspaceRoot: tmpDir,
+      logger: {
+        info: () => {},
+        success: () => {},
+        warn: warnSpy,
+        error: () => {},
+        debug: () => {},
+      },
+      outputFormat: "pretty",
+      dryRun: false,
+    } as unknown as ForgeRuntimeContext;
+
+    await runMissionArchive(makeInput(), ctx);
+
+    expect(warnSpy).toHaveBeenCalledWith(
+      expect.stringContaining("test-m007: closed mission has no releaseId"),
+    );
+  });
+
+  test("closed mission with releaseId → no warning", async () => {
+    const missionDir = path.join(missionsDir, "test-m008");
+    await fs.mkdir(missionDir, { recursive: true });
+    await fs.writeFile(
+      path.join(missionDir, "mission.yaml"),
+      `missionId: test-m008\nstate: closed\nreleaseId: test-r000001\n`,
+    );
+    const warnSpy = vi.fn();
+    const ctx: ForgeRuntimeContext = {
+      workspaceRoot: tmpDir,
+      logger: {
+        info: () => {},
+        success: () => {},
+        warn: warnSpy,
+        error: () => {},
+        debug: () => {},
+      },
+      outputFormat: "pretty",
+      dryRun: false,
+    } as unknown as ForgeRuntimeContext;
+
+    await runMissionArchive(makeInput(), ctx);
+
+    expect(
+      warnSpy.mock.calls.some(
+        (c) =>
+          typeof c[0] === "string" && c[0].includes("test-m008: closed mission has no releaseId"),
+      ),
+    ).toBe(false);
+  });
+
   test("destination exists → skipped with 'destination exists' reason", async () => {
     await writeMissionManifest(missionsDir, "test-m007", "closed");
     const archiveDir = path.join(missionsDir, "archive", "closed", "test-m007");

package/os/mission/handlers/archive.ts

@@ -69,6 +69,19 @@ function isCacheEntry(name: string): boolean {
   return name.startsWith(".") || name === "node_modules" || name === "dist";
 }
 
+async function readMissionReleaseId(missionDir: string): Promise<string | null> {
+  const manifestPath = path.join(missionDir, "mission.yaml");
+  try {
+    const raw = await fs.readFile(manifestPath, "utf8");
+    const parsed = parseYaml(raw) as Record<string, unknown>;
+    const releaseId = parsed?.releaseId;
+    if (typeof releaseId === "string" && releaseId.trim()) return releaseId.trim();
+  } catch {
+    // fall through
+  }
+  return null;
+}
+
 async function readMissionState(missionDir: string): Promise<string | null> {
   const manifestPath = path.join(missionDir, "mission.yaml");
   try {
@@ -337,6 +350,18 @@ export async function runMissionArchive(
       continue;
     }
 
+    // Warn when archiving a closed mission without a release — operator likely
+    // forgot to run release.prepare before archiving. Non-blocking: some missions
+    // (e.g. aborted, content-only) legitimately have no release.
+    if (state === "closed" && !dryRun) {
+      const releaseId = await readMissionReleaseId(missionDir);
+      if (!releaseId && outputFormat === "pretty") {
+        logger.warn(
+          `  ⚠ ${missionId}: closed mission has no releaseId — run release.prepare before archiving if this mission needs deployment`,
+        );
+      }
+    }
+
     const targetDir = path.join(missionsPath, ARCHIVE_DIR_NAME, state);
     const targetPath = path.join(targetDir, missionId);
     const targetRel = `${MISSIONS_DIR}/${ARCHIVE_DIR_NAME}/${state}/${missionId}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "4.1.3",
+  "version": "4.1.4",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",

package/src/compass/contract-registry.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./contract-registry.ts";
+
+describe("contract-registry (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/compass/types.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./types.ts";
+
+describe("compass types (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/config/forge-config.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./forge-config.ts";
+
+describe("forge-config (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/forge-module.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./forge-module.ts";
+
+describe("forge-module (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/knowledge/budgets.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./budgets.ts";
+
+describe("knowledge budgets (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/knowledge/compact.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./compact.ts";
+
+describe("knowledge compact (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/knowledge/parse.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./parse.ts";
+
+describe("knowledge parse (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/knowledge/schema.test.ts

@@ -0,0 +1,60 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import { knowledgeEntryMetaSchema } from "./schema.ts";
+
+describe("knowledgeEntryMetaSchema", () => {
+  it("parses a valid L0 entry", () => {
+    const result = knowledgeEntryMetaSchema.safeParse({
+      id: "K-0001",
+      layer: "L0",
+      created: "2026-01-01",
+      status: "active",
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it("parses a valid L2 entry with confirmations and lastConfirmedAt", () => {
+    const result = knowledgeEntryMetaSchema.safeParse({
+      id: "K-0002",
+      layer: "L2",
+      created: "2026-01-01",
+      lastConfirmedAt: "2026-06-01",
+      confirmations: 3,
+      status: "active",
+    });
+    expect(result.success).toBe(true);
+  });
+
+  it("rejects L0 entries with confirmations", () => {
+    const result = knowledgeEntryMetaSchema.safeParse({
+      id: "K-0003",
+      layer: "L0",
+      created: "2026-01-01",
+      confirmations: 1,
+      status: "active",
+    });
+    expect(result.success).toBe(false);
+  });
+
+  it("rejects L2 entries without confirmations", () => {
+    const result = knowledgeEntryMetaSchema.safeParse({
+      id: "K-0004",
+      layer: "L2",
+      created: "2026-01-01",
+      status: "active",
+    });
+    expect(result.success).toBe(false);
+  });
+
+  it("rejects invalid id format", () => {
+    const result = knowledgeEntryMetaSchema.safeParse({
+      id: "K-001",
+      layer: "L0",
+      created: "2026-01-01",
+      status: "active",
+    });
+    expect(result.success).toBe(false);
+  });
+});

package/src/onboarding/create.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./create.ts";
+
+describe("onboarding/create (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/onboarding/doctor.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./doctor.ts";
+
+describe("onboarding/doctor (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/onboarding/init.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./init.ts";
+
+describe("onboarding/init (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/onboarding/scaffold.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./scaffold.ts";
+
+describe("onboarding/scaffold (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/onboarding/upgrade.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./upgrade.ts";
+
+describe("onboarding/upgrade (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/plugin/forge-plugin-manifest.test.ts

@@ -0,0 +1,12 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./forge-plugin-manifest.ts";
+
+describe("forge-plugin-manifest (load verification)", () => {
+  it("module loads and exports schema", () => {
+    expect(mod).toBeDefined();
+    expect(mod.forgePluginManifestSchema).toBeDefined();
+  });
+});

package/src/types/werkstatt-engine-shims.d.ts

@@ -882,6 +882,10 @@ declare module "@warpgogol/werkstatt-engine/fleet-module" {
   export function createFleetModule(...args: any[]): any;
 }
 
+declare module "@warpgogol/werkstatt-engine/lagebild-module" {
+  export function createLagebildModule(...args: any[]): any;
+}
+
 declare module "@warpgogol/werkstatt-engine/subdomain-module" {
   export function createSubdomainModule(...args: any[]): any;
 }

package/src/types/werkstatt-shared-shims.d.ts

@@ -215,6 +215,7 @@ declare module "@warpgogol/werkstatt-shared/integration" {
   export const IngressOrigin: any;
   export const ExplicitPolicyAssertion: any;
   export const PolicyAssertionKind: any;
+  export const lagebildDestinationAdapter: any;
 }
 
 declare module "@warpgogol/werkstatt-shared/integration/port" {
@@ -552,11 +553,13 @@ declare module "@warpgogol/werkstatt-shared/share" {
   export function splitMarkdownSections(...args: any[]): any;
   export function extractParagraphs(...args: any[]): any;
   export function splitSentences(...args: any[]): any;
+  export function extractLists(...args: any[]): any;
   export function extractListFacts(...args: any[]): any;
   export function extractEmail(...args: any[]): any;
   export function extractPostalAddress(...args: any[]): any;
   export function mergePeople(...args: any[]): any;
   export type MarkdownSection = any;
+  export type MarkdownList = any;
   export function getBaseUrl(...args: any[]): any;
   export function toCanonicalUrl(...args: any[]): any;
   export function toAbsoluteUrl(...args: any[]): any;
@@ -585,8 +588,11 @@ declare module "@warpgogol/werkstatt-shared/share" {
   export function projectPeople(...args: any[]): any;
   export function projectLocation(...args: any[]): any;
   export function projectServices(...args: any[]): any;
+  export function projectClaims(...args: any[]): any;
   export function projectWeb(...args: any[]): any;
   export const BUSINESS_DOMAIN_VISIBILITY: any;
+  export interface SemanticClaimProvenance {}
+  export interface SemanticEvidenceRef {}
   export type BusinessDomain = any;
   export type BusinessVisibility = any;
   export function buildOrganizationProfile(...args: any[]): any;
@@ -652,6 +658,15 @@ declare module "@warpgogol/werkstatt-shared/share" {
   export const PRICE_MARKER_RE: any;
   export const AMOUNT_MARKER_RE: any;
   export interface DerivedPriceEntry {}
+  export function deriveCanonicalUri(...args: any[]): any;
+  export type CanonicalEntityType = any;
+  export function normalizeFactValue(...args: any[]): any;
+  export interface CanonicalFact {}
+  export function calculateAgeDays(...args: any[]): any;
+  export function isAssessmentStale(...args: any[]): any;
+  export function isItemStale(...args: any[]): any;
+  export const DEFAULT_FRESHNESS_WINDOW_DAYS: any;
+  export interface FreshnessViolation {}
   export function createLanguageRedirectMiddleware(...args: any[]): any;
   export function resolvePseoBudget(...args: any[]): any;
   export function isValidFeature(...args: any[]): any;
@@ -1080,6 +1095,7 @@ declare module "@warpgogol/werkstatt-shared/share/agent" {
   export const AGENT_SURFACE_VERSION: any;
   export interface AgentKnowledgeRef {}
   export interface AgentActionRef {}
+  export interface AgentClaimRef {}
   export interface AgentSurfaceManifest {}
   export interface AgentSurfaceManifestInput {}
   export function isAgentKnowledgeDomain(...args: any[]): any;
@@ -1507,8 +1523,10 @@ declare module "@warpgogol/werkstatt-shared/share/page" {
 }
 
 declare module "@warpgogol/werkstatt-shared/share/redirects" {
+  export function buildPageRouteExclusionAlternation(...args: any[]): any;
   export function parseRedirectRules(...args: any[]): any;
   export function extractRedirectTarget(...args: any[]): any;
+  export const PAGE_ROUTE_EXCLUDED_EXTENSIONS: any;
   export type RedirectRule = any;
 }
 
@@ -1518,6 +1536,17 @@ declare module "@warpgogol/werkstatt-shared/share/remediation" {
   export interface RemediationPattern {}
 }
 
+declare module "@warpgogol/werkstatt-shared/share/pbt" {
+  export function fcAssert(...args: any[]): any;
+  export function letterString(...args: any[]): any;
+  export function composeWord(...args: any[]): any;
+  export function safeText(...args: any[]): any;
+  export const DEFAULT_NUM_RUNS: any;
+  export const DEFAULT_MAX_SKIPS_PER_RUN: any;
+  export interface FcAssertOptions {}
+  export interface ComposeWordOptions {}
+}
+
 declare module "@warpgogol/werkstatt-shared/share/rfc0042-utils" {
   export function need(...args: any[]): any;
   export function cast(...args: any[]): any;
@@ -1958,11 +1987,13 @@ declare module "@warpgogol/werkstatt-shared/share/semantic" {
   export function splitMarkdownSections(...args: any[]): any;
   export function extractParagraphs(...args: any[]): any;
   export function splitSentences(...args: any[]): any;
+  export function extractLists(...args: any[]): any;
   export function extractListFacts(...args: any[]): any;
   export function extractEmail(...args: any[]): any;
   export function extractPostalAddress(...args: any[]): any;
   export function mergePeople(...args: any[]): any;
   export type MarkdownSection = any;
+  export type MarkdownList = any;
   export function getBaseUrl(...args: any[]): any;
   export function toCanonicalUrl(...args: any[]): any;
   export function toAbsoluteUrl(...args: any[]): any;
@@ -1991,8 +2022,11 @@ declare module "@warpgogol/werkstatt-shared/share/semantic" {
   export function projectPeople(...args: any[]): any;
   export function projectLocation(...args: any[]): any;
   export function projectServices(...args: any[]): any;
+  export function projectClaims(...args: any[]): any;
   export function projectWeb(...args: any[]): any;
   export const BUSINESS_DOMAIN_VISIBILITY: any;
+  export interface SemanticClaimProvenance {}
+  export interface SemanticEvidenceRef {}
   export type BusinessDomain = any;
   export type BusinessVisibility = any;
   export function buildOrganizationProfile(...args: any[]): any;
@@ -2058,12 +2092,39 @@ declare module "@warpgogol/werkstatt-shared/share/semantic" {
   export const PRICE_MARKER_RE: any;
   export const AMOUNT_MARKER_RE: any;
   export interface DerivedPriceEntry {}
+  export function deriveCanonicalUri(...args: any[]): any;
+  export type CanonicalEntityType = any;
+  export function normalizeFactValue(...args: any[]): any;
+  export interface CanonicalFact {}
+  export function calculateAgeDays(...args: any[]): any;
+  export function isAssessmentStale(...args: any[]): any;
+  export function isItemStale(...args: any[]): any;
+  export const DEFAULT_FRESHNESS_WINDOW_DAYS: any;
+  export interface FreshnessViolation {}
 }
 
 declare module "@warpgogol/werkstatt-shared/share/semantic/derived-prices-loader" {
   export function loadDerivedPrices(...args: any[]): any;
 }
 
+declare module "@warpgogol/werkstatt-shared/share/semantic/canonical-uri" {
+  export function deriveCanonicalUri(...args: any[]): any;
+  export type CanonicalEntityType = any;
+}
+
+declare module "@warpgogol/werkstatt-shared/share/semantic/fact-extraction" {
+  export function normalizeFactValue(...args: any[]): any;
+  export interface CanonicalFact {}
+}
+
+declare module "@warpgogol/werkstatt-shared/share/semantic/freshness" {
+  export function calculateAgeDays(...args: any[]): any;
+  export function isAssessmentStale(...args: any[]): any;
+  export function isItemStale(...args: any[]): any;
+  export const DEFAULT_FRESHNESS_WINDOW_DAYS: any;
+  export interface FreshnessViolation {}
+}
+
 declare module "@warpgogol/werkstatt-shared/share/shared-context" {
   export function buildSharedContextPageOrder(...args: any[]): any;
   export function collectSharedContextCandidatesByLevel(...args: any[]): any;
@@ -2109,6 +2170,37 @@ declare module "@warpgogol/werkstatt-shared/share/text-normalize" {
   export type NormalizableKind = any;
 }
 
+declare module "@warpgogol/werkstatt-shared/share/typography" {
+  export const extractTextSurface: any;
+  export const TECHNICAL_KEYS: any;
+  export const deriveFileLocale: any;
+  export const TextSegment: any;
+  export const TextSegmentSource: any;
+  export const TextSurfaceOptions: any;
+  export const YamlError: any;
+  export const ExtractTextSurfaceResult: any;
+  export const TIER1_RULES: any;
+  export const DEFAULT_ALLOWED_TOKENS: any;
+  export const createTypographyContext: any;
+  export const TypographyRuleId: any;
+  export const TypographyRuleFamily: any;
+  export const TypographyFinding: any;
+  export const TypographyRule: any;
+  export const TypographyContext: any;
+  export const TIER2_STRUCTURE_RULES: any;
+  export const TIER2_LOCALE_RULES: any;
+  export const Tier2LocaleRuleId: any;
+  export const TIER3_ADVISORY_RULES: any;
+  export const Tier3AdvisoryRuleId: any;
+  export const LOCALE_DEFAULTS: any;
+  export const getLocaleDefaults: any;
+  export const LocaleTypographyDefaults: any;
+  export const FixAction: any;
+  export const FIXABLE_RULE_IDS: any;
+  export const isFixable: any;
+  export const applyFixes: any;
+}
+
 declare module "@warpgogol/werkstatt-shared/share/text-position" {
   export function getLineColumn(...args: any[]): any;
 }
@@ -2288,8 +2380,6 @@ declare module "@warpgogol/werkstatt-shared/index" {
 declare module "@warpgogol/werkstatt-shared/integration/adapters" {
   export const telegramChannelAdapter: any;
   export const whatsappChannelAdapter: any;
-  export const pipedriveCrmAdapter: any;
-  export const pipedriveDestinationAdapter: any;
 }
 
 declare module "@warpgogol/werkstatt-shared/integration/dispatch" {
@@ -2421,6 +2511,7 @@ declare module "@warpgogol/werkstatt-shared/integration/index" {
   export const IngressOrigin: any;
   export const ExplicitPolicyAssertion: any;
   export const PolicyAssertionKind: any;
+  export const lagebildDestinationAdapter: any;
 }
 
 declare module "@warpgogol/werkstatt-shared/integration/lifecycle" {
@@ -2960,6 +3051,7 @@ declare module "@warpgogol/werkstatt-shared/ontology/schemas/system/release" {
 declare module "@warpgogol/werkstatt-shared/ontology/schemas/system/text" {
   export const systemTextNormalizeSignalsSchema: any;
   export const systemTextNormalizeSchema: any;
+  export const systemTypographySchema: any;
   export const systemTextSchema: any;
   export type SystemText = any;
 }
@@ -3107,6 +3199,7 @@ declare module "@warpgogol/werkstatt-shared/share/agent/index" {
   export const AGENT_SURFACE_VERSION: any;
   export interface AgentKnowledgeRef {}
   export interface AgentActionRef {}
+  export interface AgentClaimRef {}
   export interface AgentSurfaceManifest {}
   export interface AgentSurfaceManifestInput {}
   export function isAgentKnowledgeDomain(...args: any[]): any;
@@ -3185,6 +3278,7 @@ declare module "@warpgogol/werkstatt-shared/share/agent/manifest" {
   export const AGENT_SURFACE_VERSION: any;
   export interface AgentKnowledgeRef {}
   export interface AgentActionRef {}
+  export interface AgentClaimRef {}
   export interface AgentSurfaceManifest {}
   export interface AgentSurfaceManifestInput {}
 }
@@ -3330,8 +3424,6 @@ declare module "@warpgogol/werkstatt-shared/share/env.d" {
   export const INTEGRATION_WHATSAPP_TOKEN: any;
   export const INTEGRATION_WHATSAPP_PHONE_ID: any;
   export const INTEGRATION_WHATSAPP_TO: any;
-  export const INTEGRATION_PIPEDRIVE_API_TOKEN: any;
-  export const INTEGRATION_PIPEDRIVE_DOMAIN: any;
   export const INTEGRATION_INBOUND_SECRET: any;
   export const UPSTASH_QSTASH_URL: any;
   export const UPSTASH_QSTASH_TOKEN: any;
@@ -3408,11 +3500,13 @@ declare module "@warpgogol/werkstatt-shared/share/index" {
   export function splitMarkdownSections(...args: any[]): any;
   export function extractParagraphs(...args: any[]): any;
   export function splitSentences(...args: any[]): any;
+  export function extractLists(...args: any[]): any;
   export function extractListFacts(...args: any[]): any;
   export function extractEmail(...args: any[]): any;
   export function extractPostalAddress(...args: any[]): any;
   export function mergePeople(...args: any[]): any;
   export type MarkdownSection = any;
+  export type MarkdownList = any;
   export function getBaseUrl(...args: any[]): any;
   export function toCanonicalUrl(...args: any[]): any;
   export function toAbsoluteUrl(...args: any[]): any;
@@ -3441,8 +3535,11 @@ declare module "@warpgogol/werkstatt-shared/share/index" {
   export function projectPeople(...args: any[]): any;
   export function projectLocation(...args: any[]): any;
   export function projectServices(...args: any[]): any;
+  export function projectClaims(...args: any[]): any;
   export function projectWeb(...args: any[]): any;
   export const BUSINESS_DOMAIN_VISIBILITY: any;
+  export interface SemanticClaimProvenance {}
+  export interface SemanticEvidenceRef {}
   export type BusinessDomain = any;
   export type BusinessVisibility = any;
   export function buildOrganizationProfile(...args: any[]): any;
@@ -3508,6 +3605,15 @@ declare module "@warpgogol/werkstatt-shared/share/index" {
   export const PRICE_MARKER_RE: any;
   export const AMOUNT_MARKER_RE: any;
   export interface DerivedPriceEntry {}
+  export function deriveCanonicalUri(...args: any[]): any;
+  export type CanonicalEntityType = any;
+  export function normalizeFactValue(...args: any[]): any;
+  export interface CanonicalFact {}
+  export function calculateAgeDays(...args: any[]): any;
+  export function isAssessmentStale(...args: any[]): any;
+  export function isItemStale(...args: any[]): any;
+  export const DEFAULT_FRESHNESS_WINDOW_DAYS: any;
+  export interface FreshnessViolation {}
   export function createLanguageRedirectMiddleware(...args: any[]): any;
   export function resolvePseoBudget(...args: any[]): any;
   export function isValidFeature(...args: any[]): any;
@@ -4443,6 +4549,8 @@ declare module "@warpgogol/werkstatt-shared/share/scripts/index" {
   export function initLenis(...args: any[]): any;
   export type LenisInstance = any;
   export type InitLenisOptions = any;
+  export function initScrollSpy(...args: any[]): any;
+  export interface ScrollSpyOptions {}
   export function runStandardLayoutOrchestration(...args: any[]): any;
   export interface OrchestrationOptions {}
 }
@@ -4521,8 +4629,11 @@ declare module "@warpgogol/werkstatt-shared/share/semantic/business-projection"
   export function projectPeople(...args: any[]): any;
   export function projectLocation(...args: any[]): any;
   export function projectServices(...args: any[]): any;
+  export function projectClaims(...args: any[]): any;
   export function projectWeb(...args: any[]): any;
   export const BUSINESS_DOMAIN_VISIBILITY: any;
+  export interface SemanticClaimProvenance {}
+  export interface SemanticEvidenceRef {}
   export type BusinessDomain = any;
   export type BusinessVisibility = any;
 }
@@ -4532,11 +4643,13 @@ declare module "@warpgogol/werkstatt-shared/share/semantic/extract" {
   export function splitMarkdownSections(...args: any[]): any;
   export function extractParagraphs(...args: any[]): any;
   export function splitSentences(...args: any[]): any;
+  export function extractLists(...args: any[]): any;
   export function extractListFacts(...args: any[]): any;
   export function extractEmail(...args: any[]): any;
   export function extractPostalAddress(...args: any[]): any;
   export function mergePeople(...args: any[]): any;
   export type MarkdownSection = any;
+  export type MarkdownList = any;
 }
 
 declare module "@warpgogol/werkstatt-shared/share/semantic/feed" {
@@ -4607,11 +4720,13 @@ declare module "@warpgogol/werkstatt-shared/share/semantic/index" {
   export function splitMarkdownSections(...args: any[]): any;
   export function extractParagraphs(...args: any[]): any;
   export function splitSentences(...args: any[]): any;
+  export function extractLists(...args: any[]): any;
   export function extractListFacts(...args: any[]): any;
   export function extractEmail(...args: any[]): any;
   export function extractPostalAddress(...args: any[]): any;
   export function mergePeople(...args: any[]): any;
   export type MarkdownSection = any;
+  export type MarkdownList = any;
   export function getBaseUrl(...args: any[]): any;
   export function toCanonicalUrl(...args: any[]): any;
   export function toAbsoluteUrl(...args: any[]): any;
@@ -4640,8 +4755,11 @@ declare module "@warpgogol/werkstatt-shared/share/semantic/index" {
   export function projectPeople(...args: any[]): any;
   export function projectLocation(...args: any[]): any;
   export function projectServices(...args: any[]): any;
+  export function projectClaims(...args: any[]): any;
   export function projectWeb(...args: any[]): any;
   export const BUSINESS_DOMAIN_VISIBILITY: any;
+  export interface SemanticClaimProvenance {}
+  export interface SemanticEvidenceRef {}
   export type BusinessDomain = any;
   export type BusinessVisibility = any;
   export function buildOrganizationProfile(...args: any[]): any;
@@ -4707,6 +4825,15 @@ declare module "@warpgogol/werkstatt-shared/share/semantic/index" {
   export const PRICE_MARKER_RE: any;
   export const AMOUNT_MARKER_RE: any;
   export interface DerivedPriceEntry {}
+  export function deriveCanonicalUri(...args: any[]): any;
+  export type CanonicalEntityType = any;
+  export function normalizeFactValue(...args: any[]): any;
+  export interface CanonicalFact {}
+  export function calculateAgeDays(...args: any[]): any;
+  export function isAssessmentStale(...args: any[]): any;
+  export function isItemStale(...args: any[]): any;
+  export const DEFAULT_FRESHNESS_WINDOW_DAYS: any;
+  export interface FreshnessViolation {}
 }
 
 declare module "@warpgogol/werkstatt-shared/share/semantic/jsonld/article" {
@@ -5536,6 +5663,8 @@ declare module "@warpgogol/werkstatt-shared/share/scripts" {
   export function initLenis(...args: any[]): any;
   export type LenisInstance = any;
   export type InitLenisOptions = any;
+  export function initScrollSpy(...args: any[]): any;
+  export interface ScrollSpyOptions {}
   export function runStandardLayoutOrchestration(...args: any[]): any;
   export interface OrchestrationOptions {}
 }

package/src/types.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./types.ts";
+
+describe("forge types (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/utils/fs-atomic.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./fs-atomic.ts";
+
+describe("utils/fs-atomic (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/utils/fs-trash-sync.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./fs-trash-sync.ts";
+
+describe("utils/fs-trash-sync (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/utils/fs.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./fs.ts";
+
+describe("utils/fs (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/utils/generated-marker.test.ts

@@ -0,0 +1,11 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import * as mod from "./generated-marker.ts";
+
+describe("utils/generated-marker (load verification)", () => {
+  it("module loads successfully", () => {
+    expect(mod).toBeDefined();
+  });
+});

package/src/utils/hash.test.ts

@@ -0,0 +1,25 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import { byteHash } from "./hash.ts";
+
+describe("byteHash", () => {
+  it("produces a sha256-prefixed hex digest for a string", () => {
+    const hash = byteHash("test");
+    expect(hash).toMatch(/^sha256:[0-9a-f]{64}$/);
+  });
+
+  it("produces a sha256-prefixed hex digest for bytes", () => {
+    const hash = byteHash(new Uint8Array([1, 2, 3]));
+    expect(hash).toMatch(/^sha256:[0-9a-f]{64}$/);
+  });
+
+  it("is deterministic for same input", () => {
+    expect(byteHash("abc")).toBe(byteHash("abc"));
+  });
+
+  it("produces different hashes for different inputs", () => {
+    expect(byteHash("abc")).not.toBe(byteHash("abd"));
+  });
+});

package/src/utils/string-utils.test.ts

@@ -0,0 +1,23 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+
+import { toKebabCase } from "./string-utils.ts";
+
+describe("toKebabCase", () => {
+  it("converts spaces to hyphens", () => {
+    expect(toKebabCase("hello world")).toBe("hello-world");
+  });
+
+  it("removes special characters", () => {
+    expect(toKebabCase("hello!@#world")).toBe("hello-world");
+  });
+
+  it("trims leading and trailing hyphens", () => {
+    expect(toKebabCase("---hello---")).toBe("hello");
+  });
+
+  it("handles empty string", () => {
+    expect(toKebabCase("")).toBe("");
+  });
+});