@coreframe/diagnostics 0.0.0 → 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# @coreframe/diagnostics
+
+Production-readiness diagnostics engine for Coreframe projects.
+
+The package is intentionally UI-independent. It gathers local project facts,
+normalizes them into a project snapshot, evaluates the snapshot into findings,
+and builds action-oriented view models that can later be consumed by
+`@coreframe/scripts` and `@coreframe/dashboard`.
+
+This package is pre-alpha. Its public contracts are shaped for experimentation
+before production command paths or dashboard UI depend on them.
+
+Diagnostics focus on the work that is not completed by the generated Coreframe
+template: human decisions, production-facing defaults, provider-console work,
+and evidence needed before launch. They do not emit findings merely to confirm
+that template-owned files, package scripts, or local defaults still exist.
+
+A healthy check should answer at least one of these questions:
+
+- What decision has not been made?
+- What manual task still needs an owner?
+- What production-facing default still needs personalization?
+- What evidence would let a human call this ready?
+
+Return no finding when there is no useful action. Local commands and passive
+context can still be exposed as dashboard controls or facts without becoming
+readiness findings.
+
+## Pipeline
+
+1. Create a `ProjectContext`.
+2. Run collectors to gather deterministic project facts.
+3. Build a normalized `ProjectSnapshot`.
+4. Run evaluators to produce prioritized findings.
+5. Attach safe commands, copyable agent prompts, and links.
+6. Build a dashboard-oriented view model from the same diagnostic result.
+
+```ts
+import { runDiagnostics } from "@coreframe/diagnostics"
+
+const result = await runDiagnostics({ projectRoot: process.cwd() })
+
+console.log(result.dashboard.headline.message)
+console.log(result.dashboard.launchItems)
+```
+
+Collectors should prefer local, low-latency signals. A failed collector should
+not fail the whole diagnostic run. Collectors must not inspect secret values.
+
+## Adding Checks
+
+Default collectors and evaluators live in one module per check.
+
+- Add collectors under `src/collectors/` and register them in
+  `src/collectors/index.ts`.
+- Add evaluators under `src/evaluators/` and register them in
+  `src/evaluators/index.ts`.
+
+The registry files intentionally use explicit imports instead of glob imports so
+the package stays easy to run through Node, Vitest, and the library build.

package/dist/src/collectors/git.js

@@ -0,0 +1,2 @@
+import{execFile as e}from"node:child_process";import{promisify as t}from"node:util";const n=t(e),r={id:`project.git`,label:`Git state`,collect:async e=>({git:await i(e.projectRoot)})};async function i(e){let[t,n,r]=await Promise.all([a([`branch`,`--show-current`],e),a([`rev-parse`,`--short`,`HEAD`],e),a([`status`,`--short`],e)]),i=r.split(`
+`).map(e=>e.trim()).filter(Boolean).length;return{available:!0,branch:t.trim()||void 0,shortCommit:n.trim()||void 0,dirty:i>0,changedFiles:i}}async function a(e,t){let{stdout:r}=await n(`git`,e,{cwd:t});return r}export{r as default};

package/dist/src/collectors/index.d.ts

@@ -0,0 +1,35 @@
+import { GitFact, LaunchReadinessFact, ProjectContext, ScriptsFact, ToolLink } from "../types.js";
+
+//#region src/collectors/index.d.ts
+declare const defaultCollectors: ({
+  id: string;
+  label: string;
+  collect: (context: ProjectContext) => Promise<{
+    package: {
+      name: string | undefined;
+      version: string | undefined;
+      private: boolean | undefined;
+    };
+    scripts: ScriptsFact;
+  }>;
+} | {
+  id: string;
+  label: string;
+  collect: (context: ProjectContext) => Promise<{
+    git: GitFact;
+  }>;
+} | {
+  id: string;
+  label: string;
+  collect: (context: ProjectContext) => Promise<{
+    launchReadiness: LaunchReadinessFact;
+  }>;
+} | {
+  id: string;
+  label: string;
+  collect: (context: ProjectContext) => Promise<{
+    links: ToolLink[];
+  }>;
+})[];
+//#endregion
+export { defaultCollectors };

package/dist/src/collectors/index.js

@@ -0,0 +1 @@
+import e from"./git.js";import t from"./launch-readiness.js";import n from"./links.js";import r from"./package-json.js";const i=[r,e,t,n];export{i as defaultCollectors};

package/dist/src/collectors/launch-readiness.js

@@ -0,0 +1 @@
+import{readFile as e}from"node:fs/promises";import{join as t}from"node:path";const n={id:`launch.readiness`,label:`Launch readiness`,collect:async e=>({launchReadiness:await r(e.projectRoot)})};async function r(e){let[n,r,s,c,l,u,d]=await Promise.all([o(t(e,`docs/production-checklist.md`)),o(t(e,`src/web/root.tsx`)),o(t(e,`tauri/src-tauri/tauri.conf.json`)),o(t(e,`wrangler.jsonc`)),o(t(e,`content/legal/en/privacy.md`)),o(t(e,`content/legal/en/terms.md`)),o(t(e,`docs/privacy-security-notes.md`))]),f=a(s,`identifier`);return{productionChecklistExists:n!==void 0,defaultIdentity:[i(r?.includes(`<title>Coreframe</title>`),`Web title`,`Coreframe`),i(s?.includes(`"productName": "Coreframe"`),`App name`,`Coreframe`),i(f===`com.coreframe.app`||f===`com.example`||f?.startsWith(`com.example.`),`App identifier`,f),i(c?.includes(`"name": "api"`),`Worker name`,`api`)].filter(e=>e!==void 0),defaultLegalDocuments:[l?.includes(`Replace this template copy`)?`Privacy policy`:void 0,u?.includes(`Replace this template copy`)?`Terms of service`:void 0].filter(e=>e!==void 0),privacyReviewRecorded:d!==void 0&&!d.includes(`No final-pass review recorded yet`)&&/^- Date:\s*\S+/mu.test(d)}}function i(e,t,n){return e?{label:t,value:n}:void 0}function a(e,t){if(e)return RegExp(`"${t}"\\s*:\\s*"([^"]+)"`,`u`).exec(e)?.[1]}async function o(t){try{return await e(t,`utf8`)}catch(e){if(s(e)&&e.code===`ENOENT`)return;throw e}}function s(e){return e instanceof Error&&`code`in e}export{n as default};

package/dist/src/collectors/links.js

@@ -0,0 +1 @@
+const e={id:`project.links`,label:`Configured links`,collect:async e=>({links:t(e.env??process.env)})};function t(e){let t=[];return e.POSTHOG_PROJECT_URL&&t.push({id:`posthog`,label:`PostHog`,href:e.POSTHOG_PROJECT_URL,area:`integration`}),e.CLOUDFLARE_DASHBOARD_URL&&t.push({id:`cloudflare`,label:`Cloudflare`,href:e.CLOUDFLARE_DASHBOARD_URL,area:`deploy`}),e.DRIZZLE_STUDIO_URL&&t.push({id:`drizzle-studio`,label:`Drizzle Studio`,href:e.DRIZZLE_STUDIO_URL,area:`database`}),t}export{e as default};

package/dist/src/collectors/package-json.js

@@ -0,0 +1 @@
+import{readFile as e}from"node:fs/promises";import{join as t}from"node:path";const n={id:`project.package`,label:`Package identity`,collect:async e=>{let n=await i(t(e.projectRoot,`package.json`));return{package:{name:n.name,version:n.version,private:n.private},scripts:r(n.scripts??{})}}};function r(e){return{names:Object.keys(e).sort(),devCommand:e.dev,testCommand:e.test,typecheckCommand:e.typecheck,buildCommand:e.build,deployCommand:e[`deploy:production`]??e.deploy}}async function i(t){return JSON.parse(await e(t,`utf8`))}export{n as default};

package/dist/src/collectors.d.ts

@@ -0,0 +1,21 @@
+import { CollectorResult, ProjectContext, ProjectFacts, ProjectSnapshot } from "./types.js";
+import { defaultCollectors } from "./collectors/index.js";
+
+//#region src/collectors.d.ts
+type Collector = {
+  id: string;
+  label: string;
+  collect: (context: ProjectContext) => Promise<Partial<ProjectFacts>>;
+};
+type RunCollectorsOptions = {
+  collectors?: Collector[];
+  timeoutMs?: number;
+};
+declare const defaultCollectorTimeoutMs = 1500;
+declare function collectSnapshot(context: ProjectContext, options?: RunCollectorsOptions): Promise<ProjectSnapshot>;
+declare function runCollectors(context: ProjectContext, options?: RunCollectorsOptions): Promise<{
+  facts: ProjectFacts;
+  collectors: CollectorResult[];
+}>;
+//#endregion
+export { Collector, RunCollectorsOptions, collectSnapshot, defaultCollectorTimeoutMs, defaultCollectors, runCollectors };

package/dist/src/collectors.js

@@ -0,0 +1 @@
+import{defaultCollectors as e}from"./collectors/index.js";const t=1500;async function n(e,t={}){let n=await r(e,t);return{projectRoot:e.projectRoot,environment:e.environment??`development`,facts:n.facts,collectors:n.collectors,collectedAt:new Date().toISOString()}}async function r(t,n={}){let r=n.timeoutMs??t.collectorTimeoutMs??1500,a=n.collectors??e,o={},s=[];for(let e of a){let n=Date.now();try{let a=await i(e.collect(t),r,e.id);Object.assign(o,a),s.push({id:e.id,label:e.label,state:`available`,durationMs:Date.now()-n})}catch(t){s.push({id:e.id,label:e.label,state:`unavailable`,durationMs:Date.now()-n,reason:t instanceof Error?t.message:String(t)})}}return{facts:o,collectors:s}}async function i(e,t,n){let r;try{return await Promise.race([e,new Promise((e,i)=>{r=setTimeout(()=>{i(Error(`Collector ${n} timed out after ${t}ms`))},t)})])}finally{r&&clearTimeout(r)}}export{n as collectSnapshot,t as defaultCollectorTimeoutMs,e as defaultCollectors,r as runCollectors};

package/dist/src/evaluators/actions.js

@@ -0,0 +1 @@
+function e(e,t){return{kind:`agent_prompt`,label:e,prompt:t}}export{e as agentPrompt};

package/dist/src/evaluators/index.d.ts

@@ -0,0 +1,44 @@
+import { AgentPromptAction, Evidence, ProjectSnapshot } from "../types.js";
+
+//#region src/evaluators/index.d.ts
+declare const defaultEvaluators: ({
+  id: string;
+  evaluate: (snapshot: ProjectSnapshot) => {
+    id: string;
+    title: string;
+    summary: string;
+    severity: "warning";
+    status: "needs_action";
+    area: "launch";
+    actions: AgentPromptAction[];
+  }[];
+} | {
+  id: string;
+  evaluate: (snapshot: ProjectSnapshot) => {
+    id: string;
+    title: string;
+    summary: string;
+    severity: "warning";
+    status: "needs_action";
+    area: "product";
+    evidence: Evidence[];
+    actions: AgentPromptAction[];
+  }[];
+} | {
+  id: string;
+  evaluate: (snapshot: ProjectSnapshot) => {
+    id: string;
+    title: string;
+    summary: string;
+    severity: "warning";
+    status: "needs_action";
+    area: "legal";
+    evidence: {
+      label: string;
+      value: string;
+    }[];
+    actions: AgentPromptAction[];
+  }[];
+})[];
+//#endregion
+export { defaultEvaluators };

package/dist/src/evaluators/index.js

@@ -0,0 +1 @@
+import e from"./launch-scope.js";import t from"./legal-review.js";import n from"./product-identity.js";const r=[e,n,t];export{r as defaultEvaluators};

package/dist/src/evaluators/launch-scope.js

@@ -0,0 +1 @@
+import{agentPrompt as e}from"./actions.js";const t={id:`launch.scope`,evaluate:t=>t.facts.launchReadiness?.productionChecklistExists?[]:[{id:`launch.scope.undecided`,title:`First-release scope has not been decided`,summary:`The template wires several optional production services, but the project does not record which ones are required, deferred, or removed for the first release.`,severity:`warning`,status:`needs_action`,area:`launch`,actions:[e(`Decide first-release services`,`Inspect docs/stack-setup.md and the integrations wired into this Coreframe project. Ask me which capabilities are required for the first production release, which are deferred, and whether any additional services are needed. Then create docs/production-checklist.md for the confirmed scope without creating accounts or production credentials.`)]}]};export{t as default};

package/dist/src/evaluators/legal-review.js

@@ -0,0 +1 @@
+import{agentPrompt as e}from"./actions.js";const t={id:`legal.review`,evaluate:t=>{let n=t.facts.launchReadiness;if(!n)return[];let r=[...n.defaultLegalDocuments,...n.privacyReviewRecorded?[]:[`Privacy/security final-pass review`]];return r.length===0?[]:[{id:`legal.review.incomplete`,title:`Legal and privacy review needs human decisions`,summary:`Production-facing legal copy or the privacy/security evidence review is still in its template state.`,severity:`warning`,status:`needs_action`,area:`legal`,evidence:[{label:`Outstanding`,value:r.join(`, `)}],actions:[e(`Prepare legal and privacy review`,`Inspect the shipped product behavior, content/legal/en/privacy.md, content/legal/en/terms.md, docs/privacy-security-notes.md, and the privacy/security final-pass rule. Replace unsupported template claims with evidence-backed notes, identify the company, contact, jurisdiction, retention, deletion, and billing decisions that require human or legal review, and do not present generated copy as legal advice.`)]}]}};export{t as default};

package/dist/src/evaluators/product-identity.js

@@ -0,0 +1 @@
+import{agentPrompt as e}from"./actions.js";const t={id:`product.identity`,evaluate:t=>{let n=[...t.facts.launchReadiness?.defaultIdentity??[]];return t.facts.package?.name===`coreframe`&&n.unshift({label:`Package name`,value:`coreframe`}),n.length===0?[]:[{id:`product.identity.defaults`,title:`Production identity still uses placeholders`,summary:`Names or identifiers visible to users and deployment platforms still use template or development defaults.`,severity:`warning`,status:`needs_action`,area:`product`,evidence:n,actions:[e(`Personalize product identity`,`Ask me for the approved product name, package slug, deployment name, and organization-owned reverse-domain native app identifier. Update only the identity values that still use template or development defaults, ensure com.example is replaced before native distribution, then summarize any store, DNS, or provider-console names that still require human action.`)]}]}};export{t as default};

package/dist/src/evaluators.d.ts

@@ -0,0 +1,12 @@
+import { Finding, FindingArea, ProjectSnapshot } from "./types.js";
+import { defaultEvaluators } from "./evaluators/index.js";
+
+//#region src/evaluators.d.ts
+type Evaluator = {
+  id: string;
+  evaluate: (snapshot: ProjectSnapshot) => Finding[];
+};
+declare function evaluateSnapshot(snapshot: ProjectSnapshot, evaluators?: Evaluator[]): Finding[];
+declare function findingsByArea(findings: Finding[], area: FindingArea): Finding[];
+//#endregion
+export { Evaluator, defaultEvaluators, evaluateSnapshot, findingsByArea };

package/dist/src/evaluators.js

@@ -0,0 +1 @@
+import{defaultEvaluators as e}from"./evaluators/index.js";function t(t,r=e){return n(r.flatMap(e=>e.evaluate(t)))}function n(e){let t={error:0,warning:1,info:2},n={blocked:0,needs_action:1,unknown:2,ok:3};return[...e].sort((e,r)=>{let i=t[e.severity]-t[r.severity];return i===0?n[e.status]-n[r.status]:i})}function r(e,t){return e.filter(e=>e.area===t)}export{e as defaultEvaluators,t as evaluateSnapshot,r as findingsByArea};

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+import { AgentPromptAction, CollectorResult, CollectorState, CommandAction, DashboardModel, DiagnosticAction, DiagnosticResult, DiagnosticSeverity, DiagnosticStatus, EnvironmentMode, Evidence, Finding, FindingArea, GitFact, HeadlineStatus, LaunchReadinessFact, LinkAction, PackageFact, ProjectContext, ProjectFacts, ProjectSnapshot, ScriptsFact, ToolLink } from "./types.js";
+import { defaultCollectors } from "./collectors/index.js";
+import { Collector, RunCollectorsOptions, collectSnapshot, defaultCollectorTimeoutMs, runCollectors } from "./collectors.js";
+import { defaultEvaluators } from "./evaluators/index.js";
+import { Evaluator, evaluateSnapshot, findingsByArea } from "./evaluators.js";
+import { RunDiagnosticsOptions, runDiagnostics } from "./run.js";
+import { buildDashboardModel, visibleLinks } from "./view-model.js";
+export { type AgentPromptAction, type Collector, type CollectorResult, type CollectorState, type CommandAction, type DashboardModel, type DiagnosticAction, type DiagnosticResult, type DiagnosticSeverity, type DiagnosticStatus, type EnvironmentMode, type Evaluator, type Evidence, type Finding, type FindingArea, type GitFact, type HeadlineStatus, type LaunchReadinessFact, type LinkAction, type PackageFact, type ProjectContext, type ProjectFacts, type ProjectSnapshot, type RunCollectorsOptions, type RunDiagnosticsOptions, type ScriptsFact, type ToolLink, buildDashboardModel, collectSnapshot, defaultCollectorTimeoutMs, defaultCollectors, defaultEvaluators, evaluateSnapshot, findingsByArea, runCollectors, runDiagnostics, visibleLinks };

package/dist/src/index.js

@@ -0,0 +1 @@
+import{defaultCollectors as e}from"./collectors/index.js";import{collectSnapshot as t,defaultCollectorTimeoutMs as n,runCollectors as r}from"./collectors.js";import{defaultEvaluators as i}from"./evaluators/index.js";import{evaluateSnapshot as a,findingsByArea as o}from"./evaluators.js";import{buildDashboardModel as s,visibleLinks as c}from"./view-model.js";import{runDiagnostics as l}from"./run.js";export{s as buildDashboardModel,t as collectSnapshot,n as defaultCollectorTimeoutMs,e as defaultCollectors,i as defaultEvaluators,a as evaluateSnapshot,o as findingsByArea,r as runCollectors,l as runDiagnostics,c as visibleLinks};

package/dist/src/run.d.ts

@@ -0,0 +1,12 @@
+import { DiagnosticResult, ProjectContext } from "./types.js";
+import { Collector, RunCollectorsOptions } from "./collectors.js";
+import { Evaluator } from "./evaluators.js";
+
+//#region src/run.d.ts
+type RunDiagnosticsOptions = RunCollectorsOptions & {
+  collectors?: Collector[];
+  evaluators?: Evaluator[];
+};
+declare function runDiagnostics(context: ProjectContext, options?: RunDiagnosticsOptions): Promise<DiagnosticResult>;
+//#endregion
+export { RunDiagnosticsOptions, runDiagnostics };

package/dist/src/run.js

@@ -0,0 +1 @@
+import{collectSnapshot as e}from"./collectors.js";import{evaluateSnapshot as t}from"./evaluators.js";import{buildDashboardModel as n}from"./view-model.js";async function r(r,i={}){let a=await e(r,i),o=t(a,i.evaluators);return{snapshot:a,findings:o,dashboard:n(a,o)}}export{r as runDiagnostics};

package/dist/src/types.d.ts

@@ -0,0 +1,113 @@
+//#region src/types.d.ts
+type EnvironmentMode = "development" | "preview" | "production";
+type DiagnosticSeverity = "info" | "warning" | "error";
+type DiagnosticStatus = "ok" | "needs_action" | "blocked" | "unknown";
+type FindingArea = "setup" | "local_dev" | "database" | "deploy" | "runtime" | "integration" | "launch" | "legal" | "product" | "project";
+type CollectorState = "available" | "unavailable";
+type HeadlineStatus = "ready" | "needs_setup" | "broken_locally" | "not_deploy_ready" | "unknown";
+type ProjectContext = {
+  projectRoot: string;
+  environment?: EnvironmentMode;
+  env?: NodeJS.ProcessEnv;
+  collectorTimeoutMs?: number;
+};
+type ToolLink = {
+  id: string;
+  label: string;
+  href: string;
+  area?: FindingArea;
+};
+type PackageFact = {
+  name?: string;
+  version?: string;
+  private?: boolean;
+};
+type ScriptsFact = {
+  names: string[];
+  devCommand?: string;
+  testCommand?: string;
+  typecheckCommand?: string;
+  buildCommand?: string;
+  deployCommand?: string;
+};
+type LaunchReadinessFact = {
+  productionChecklistExists: boolean;
+  defaultIdentity: Evidence[];
+  defaultLegalDocuments: string[];
+  privacyReviewRecorded: boolean;
+};
+type GitFact = {
+  available: boolean;
+  branch?: string;
+  shortCommit?: string;
+  dirty: boolean;
+  changedFiles: number;
+};
+type ProjectFacts = {
+  package?: PackageFact;
+  scripts?: ScriptsFact;
+  launchReadiness?: LaunchReadinessFact;
+  git?: GitFact;
+  links?: ToolLink[];
+};
+type CollectorResult = {
+  id: string;
+  label: string;
+  state: CollectorState;
+  durationMs: number;
+  reason?: string;
+};
+type ProjectSnapshot = {
+  projectRoot: string;
+  environment: EnvironmentMode;
+  facts: ProjectFacts;
+  collectors: CollectorResult[];
+  collectedAt: string;
+};
+type Evidence = {
+  label: string;
+  value?: string | number | boolean;
+};
+type AgentPromptAction = {
+  kind: "agent_prompt";
+  label: string;
+  prompt: string;
+};
+type CommandAction = {
+  kind: "command";
+  label: string;
+  command: string;
+  safety: "local_safe" | "requires_confirmation";
+};
+type LinkAction = {
+  kind: "link";
+  label: string;
+  href: string;
+};
+type DiagnosticAction = AgentPromptAction | CommandAction | LinkAction;
+type Finding = {
+  id: string;
+  title: string;
+  summary: string;
+  severity: DiagnosticSeverity;
+  status: DiagnosticStatus;
+  area: FindingArea;
+  evidence?: Evidence[];
+  actions: DiagnosticAction[];
+};
+type DashboardModel = {
+  headline: {
+    status: HeadlineStatus;
+    message: string;
+  };
+  launchItems: Finding[];
+  problems: Finding[];
+  links: ToolLink[];
+};
+type DiagnosticResult = {
+  snapshot: ProjectSnapshot;
+  findings: Finding[];
+  dashboard: DashboardModel;
+};
+//#endregion
+export { AgentPromptAction, CollectorResult, CollectorState, CommandAction, DashboardModel, DiagnosticAction, DiagnosticResult, DiagnosticSeverity, DiagnosticStatus, EnvironmentMode, Evidence, Finding, FindingArea, GitFact, HeadlineStatus, LaunchReadinessFact, LinkAction, PackageFact, ProjectContext, ProjectFacts, ProjectSnapshot, ScriptsFact, ToolLink };

package/dist/src/view-model.d.ts

@@ -0,0 +1,7 @@
+import { DashboardModel, Finding, ProjectSnapshot, ToolLink } from "./types.js";
+
+//#region src/view-model.d.ts
+declare function buildDashboardModel(snapshot: ProjectSnapshot, findings: Finding[]): DashboardModel;
+declare function visibleLinks(snapshot: ProjectSnapshot): ToolLink[];
+//#endregion
+export { buildDashboardModel, visibleLinks };

package/dist/src/view-model.js

@@ -0,0 +1 @@
+function e(e,r){let a=r.filter(n);return{headline:t(e,r),launchItems:a,problems:r.filter(i),links:e.facts.links??[]}}function t(e,t){let r=t.find(e=>e.status===`blocked`),a=t.find(e=>e.severity===`error`),o=t.filter(n),s=t.filter(i);return r||a?{status:`broken_locally`,message:r?.title??a?.title??`Project is blocked`}:o.length>0?{status:o.some(e=>e.area===`launch`)?`needs_setup`:`not_deploy_ready`,message:`${o.length} launch item${o.length===1?``:`s`} need attention.`}:s.length>0?{status:`unknown`,message:`${s.length} project problem${s.length===1?``:`s`} need attention.`}:t.some(e=>e.status===`unknown`)?{status:`unknown`,message:`Some diagnostics are unavailable.`}:{status:`ready`,message:`${e.facts.package?.name??`Project`} has no outstanding production-readiness findings.`}}function n(e){return e.status!==`ok`&&r(e.area)}function r(e){return[`database`,`deploy`,`integration`,`launch`,`legal`,`product`].includes(e)}function i(e){return e.status!==`ok`&&!r(e.area)}function a(e){return e.facts.links??[]}export{e as buildDashboardModel,a as visibleLinks};

package/package.json

@@ -1,13 +1,32 @@
 {
   "name": "@coreframe/diagnostics",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/airlock-labs/coreframe.git",
+    "directory": "diagnostics"
+  },
+  "files": [
+    "dist/"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
   },
-  "keywords": [],
-  "author": "",
-  "license": "All rights reserved",
-  "type": "commonjs"
-}
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "tsdown": "0.22.3",
+    "typescript": "6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "format": "oxfmt",
+    "lint": "oxlint"
+  }
+}

package/readme.md

@@ -1 +0,0 @@
-Coming soon...