@owlmeans/viable-common 0.0.43 → 0.0.45

package/src/connect/references/types.ts

@@ -0,0 +1,73 @@
+import type { ConnectProjectBranding, ConnectProjectBrandingSave } from '../branding/types.js'
+import type {
+  ConnectConvertCreateBody, ConnectConvertProceedBody, ConnectConvertStartBody, ConversionStatusView, ConvertCheck
+} from '../conversion/types.js'
+import type { ConnectKitApplyBody, ConnectKitApplyResult, ConnectKitDescribe } from '../kit/types.js'
+import type { ConnectInquiryAnswerBody, ConnectOp, ConnectOpResult, ConnectOpSubmission } from '../ops/types.js'
+import type { ConnectPipelineParams, ConnectPipelineResumeBody, ConnectPipelineState } from '../pipeline/types.js'
+import type {
+  ConnectAttachBody, ConnectConfirmBody, ConnectCreateBody, ConnectModifyBody, ConnectProjectStatus,
+  ConnectProjectSummary, ConnectStoryStatus
+} from '../project/types.js'
+import type { ConnectPullQuery, ConnectSessionOpen, ConnectSessionParams, ConnectSessionView } from '../session/types.js'
+import type { ConnectReference } from './types.local.js'
+
+export interface ConnectReferences {
+  session: {
+    open: ConnectReference<{ body: ConnectSessionOpen }, ConnectSessionView>
+    openDelegated: ConnectReference<{ body: ConnectSessionOpen }, ConnectSessionView>
+    close: ConnectReference<{ params: ConnectSessionParams }, ConnectSessionView>
+  }
+  op: {
+    pull: ConnectReference<{ params: ConnectSessionParams, query: ConnectPullQuery }, ConnectOp[]>
+    submit: ConnectReference<{
+      params: { sessionId: string, opId: string }, body: ConnectOpResult
+    }, ConnectOpSubmission>
+  }
+  project: {
+    create: ConnectReference<{ body: ConnectCreateBody }, ConnectProjectStatus>
+    confirm: ConnectReference<{ params: { id: string }, body: ConnectConfirmBody }, ConnectProjectStatus>
+    list: ConnectReference<{}, ConnectProjectSummary[]>
+    status: ConnectReference<{ params: { id: string } }, ConnectProjectStatus>
+    attach: ConnectReference<{ body: ConnectAttachBody }, ConnectProjectStatus>
+    reinit: ConnectReference<{ params: { id: string } }, ConnectProjectStatus>
+    modify: ConnectReference<{ params: { id: string }, body: ConnectModifyBody }, ConnectProjectStatus>
+    kit: {
+      describe: ConnectReference<{ params: { id: string } }, ConnectKitDescribe>
+      apply: ConnectReference<{ params: { id: string }, body: ConnectKitApplyBody }, ConnectKitApplyResult>
+    }
+    branding: {
+      get: ConnectReference<{ params: { id: string } }, ConnectProjectBranding>
+      save: ConnectReference<{
+        params: { id: string }, body: ConnectProjectBrandingSave
+      }, ConnectProjectBranding>
+    }
+  }
+  story: {
+    status: ConnectReference<{ params: { id: string, storyId: string } }, ConnectStoryStatus>
+  }
+  files: {
+    list: ConnectReference<{ params: { id: string } }, string[]>
+  }
+  convert: {
+    create: ConnectReference<{ body: ConnectConvertCreateBody }, ConversionStatusView>
+    check: ConnectReference<{ params: { id: string } }, ConvertCheck>
+    start: ConnectReference<{ params: { id: string }, body: ConnectConvertStartBody }, ConversionStatusView>
+    proceed: ConnectReference<{
+      params: { id: string }, body: ConnectConvertProceedBody
+    }, ConversionStatusView>
+    status: ConnectReference<{ params: { id: string } }, ConversionStatusView>
+    purge: ConnectReference<{ params: { id: string } }, ConversionStatusView>
+  }
+  inquiry: {
+    answer: ConnectReference<{
+      params: { id: string, inquiryId: string }, body: ConnectInquiryAnswerBody
+    }, unknown>
+  }
+  pipeline: {
+    state: ConnectReference<{ params: ConnectPipelineParams }, ConnectPipelineState>
+    resume: ConnectReference<{
+      params: ConnectPipelineParams, body: ConnectPipelineResumeBody
+    }, ConnectPipelineState>
+  }
+}

package/src/connect/references.ts

@@ -1,80 +1,18 @@
 import { entrypointRef } from '@owlmeans/entrypoint'
-import type { RegisteredEntrypoint, RequestShape } from '@owlmeans/entrypoint'
-import type { EntrypointReference } from '@owlmeans/context'
 import { connect } from './consts.js'
-import type { ConnectOp, ConnectOpResult } from './ops.js'
+import type { ConnectProjectBranding, ConnectProjectBrandingSave } from './branding/types.js'
 import type {
-  ConnectAttachBody, ConnectConfirmBody, ConnectCreateBody, ConnectConvertCreateBody,
-  ConnectConvertProceedBody, ConnectInquiryAnswerBody, ConnectKitApplyBody, ConnectKitApplyResult,
-  ConnectKitDescribe, ConnectModifyBody, ConnectOpSubmission,
-  ConnectPipelineParams, ConnectPipelineResumeBody, ConnectPipelineState, ConnectProjectBranding,
-  ConnectProjectBrandingSave, ConnectProjectStatus, ConnectProjectSummary, ConnectPullQuery,
-  ConnectSessionOpen, ConnectSessionParams, ConnectSessionView, ConnectStoryStatus,
-  ConversionStatusView, ConvertCheck,
-} from './types.js'
-
-type ConnectReference<Request extends RequestShape, Response> =
-  EntrypointReference<RegisteredEntrypoint<Request, Response>>
-
-export interface ConnectReferences {
-  session: {
-    open: ConnectReference<{ body: ConnectSessionOpen }, ConnectSessionView>
-    openDelegated: ConnectReference<{ body: ConnectSessionOpen }, ConnectSessionView>
-    close: ConnectReference<{ params: ConnectSessionParams }, ConnectSessionView>
-  }
-  op: {
-    pull: ConnectReference<{ params: ConnectSessionParams, query: ConnectPullQuery }, ConnectOp[]>
-    submit: ConnectReference<{
-      params: { sessionId: string, opId: string }, body: ConnectOpResult
-    }, ConnectOpSubmission>
-  }
-  project: {
-    create: ConnectReference<{ body: ConnectCreateBody }, ConnectProjectStatus>
-    confirm: ConnectReference<{ params: { id: string }, body: ConnectConfirmBody }, ConnectProjectStatus>
-    list: ConnectReference<{}, ConnectProjectSummary[]>
-    status: ConnectReference<{ params: { id: string } }, ConnectProjectStatus>
-    attach: ConnectReference<{ body: ConnectAttachBody }, ConnectProjectStatus>
-    reinit: ConnectReference<{ params: { id: string } }, ConnectProjectStatus>
-    modify: ConnectReference<{ params: { id: string }, body: ConnectModifyBody }, ConnectProjectStatus>
-    kit: {
-      describe: ConnectReference<{ params: { id: string } }, ConnectKitDescribe>
-      apply: ConnectReference<{ params: { id: string }, body: ConnectKitApplyBody }, ConnectKitApplyResult>
-    }
-    branding: {
-      get: ConnectReference<{ params: { id: string } }, ConnectProjectBranding>
-      save: ConnectReference<{
-        params: { id: string }, body: ConnectProjectBrandingSave
-      }, ConnectProjectBranding>
-    }
-  }
-  story: {
-    status: ConnectReference<{ params: { id: string, storyId: string } }, ConnectStoryStatus>
-  }
-  files: {
-    list: ConnectReference<{ params: { id: string } }, string[]>
-  }
-  convert: {
-    create: ConnectReference<{ body: ConnectConvertCreateBody }, ConversionStatusView>
-    check: ConnectReference<{ params: { id: string } }, ConvertCheck>
-    start: ConnectReference<{ params: { id: string } }, ConversionStatusView>
-    proceed: ConnectReference<{
-      params: { id: string }, body: ConnectConvertProceedBody
-    }, ConversionStatusView>
-    status: ConnectReference<{ params: { id: string } }, ConversionStatusView>
-    purge: ConnectReference<{ params: { id: string } }, ConversionStatusView>
-  }
-  inquiry: {
-    answer: ConnectReference<{
-      params: { id: string, inquiryId: string }, body: ConnectInquiryAnswerBody
-    }, unknown>
-  }
-  pipeline: {
-    state: ConnectReference<{ params: ConnectPipelineParams }, ConnectPipelineState>
-    resume: ConnectReference<{
-      params: ConnectPipelineParams, body: ConnectPipelineResumeBody
-    }, ConnectPipelineState>
-  }
-}
+  ConnectConvertCreateBody, ConnectConvertProceedBody, ConnectConvertStartBody, ConversionStatusView, ConvertCheck
+} from './conversion/types.js'
+import type { ConnectKitApplyBody, ConnectKitApplyResult, ConnectKitDescribe } from './kit/types.js'
+import type { ConnectInquiryAnswerBody, ConnectOp, ConnectOpResult, ConnectOpSubmission } from './ops/types.js'
+import type { ConnectPipelineParams, ConnectPipelineResumeBody, ConnectPipelineState } from './pipeline/types.js'
+import type {
+  ConnectAttachBody, ConnectConfirmBody, ConnectCreateBody, ConnectModifyBody, ConnectProjectStatus,
+  ConnectProjectSummary, ConnectStoryStatus
+} from './project/types.js'
+import type { ConnectReferences } from './references/types.js'
+import type { ConnectPullQuery, ConnectSessionOpen, ConnectSessionParams, ConnectSessionView } from './session/types.js'
 
 /**
  * Typed references for adapter packages that address the connector dynamically.  Applications
@@ -122,7 +60,9 @@ export const connectRef: ConnectReferences = {
   convert: {
     create: entrypointRef<{ body: ConnectConvertCreateBody }, ConversionStatusView>(connect.convert.create),
     check: entrypointRef<{ params: { id: string } }, ConvertCheck>(connect.convert.check),
-    start: entrypointRef<{ params: { id: string } }, ConversionStatusView>(connect.convert.start),
+    start: entrypointRef<{
+      params: { id: string }, body: ConnectConvertStartBody
+    }, ConversionStatusView>(connect.convert.start),
     proceed: entrypointRef<{
       params: { id: string }, body: ConnectConvertProceedBody
     }, ConversionStatusView>(connect.convert.proceed),

package/src/connect/schemas.ts

@@ -4,16 +4,16 @@ import {
   CONNECT_BRANDING_COPYRIGHT_MAX, CONNECT_BRANDING_GOOGLE_TAG_MAX,
   CONNECT_BRANDING_ORGANIZATION_MAX, CONNECT_BRANDING_URL_MAX, CONNECT_INQUIRY_MAX_TEXT,
   ConnectHarness, ConnectLlm, ConnectOpErrorKind, ConnectSessionStatus, ConnectTarget,
-  ConnectTransport, ModelTaskResultKind, ModelTier
+  ConnectTransport, ModelTaskResultKind
 } from './consts.js'
-import type { ConnectOpResult, InquiryAnswerPayload } from './ops.js'
-import type {
-  ConnectAttachBody, ConnectConfirmBody, ConnectConvertCreateBody, ConnectConvertProceedBody,
-  ConnectCreateBody, ConnectLlmBody, ConnectModifyBody, ConnectPipelineParams,
-  ConnectPipelineResumeBody, ConnectProjectBrandingSave, ConnectProjectLlmBody, ConnectSession,
-  ConnectSessionOpen, ConnectPullQuery, ConnectSessionParams, ConnectKitApplyBody, ConnectKitApplyResult,
-  ConnectKitDescribe, PlanningKitView
-} from './types.js'
+import type { ConnectProjectBrandingSave } from './branding/types.js'
+import type { ConnectConvertCreateBody, ConnectConvertProceedBody, ConnectConvertStartBody } from './conversion/types.js'
+import type { ConnectKitApplyBody, ConnectKitApplyResult, ConnectKitDescribe, PlanningKitView } from './kit/types.js'
+import type { ConnectOpResult, InquiryAnswerPayload } from './ops/types.js'
+import type { ConnectPipelineParams, ConnectPipelineResumeBody } from './pipeline/types.js'
+import type { ConnectAttachBody, ConnectConfirmBody, ConnectCreateBody, ConnectModifyBody } from './project/types.js'
+import type { ConnectPullQuery, ConnectSession, ConnectSessionOpen, ConnectSessionParams } from './session/types.js'
+import type { ConnectLlmBody, ConnectProjectLlmBody } from './settings/types.js'
 
 /**
  * A nullable ENUM carries `null` as one of its values.
@@ -377,11 +377,21 @@ export const ConnectConvertCreateBodySchema = {
   additionalProperties: false,
 } as unknown as JSONSchemaType<ConnectConvertCreateBody>
 
+export const ConnectConvertStartBodySchema = {
+  type: 'object',
+  properties: {
+    confirm: { type: 'boolean', nullable: true },
+  },
+  required: [],
+  additionalProperties: false,
+} as unknown as JSONSchemaType<ConnectConvertStartBody>
+
 export const ConnectConvertProceedBodySchema = {
   type: 'object',
   properties: {
     decision: { type: 'string', enum: Object.values(ConversionDecision) },
     note: { type: 'string', maxLength: 4096, nullable: true },
+    confirm: { type: 'boolean', nullable: true },
   },
   required: ['decision'],
   additionalProperties: false,
@@ -467,6 +477,3 @@ export const ModelTaskResultSchema = {
   required: ['taskId', 'kind'],
   additionalProperties: false,
 } as any
-
-/** Tier → the model the parent will run it on. Free-form; display only. */
-export const ModelTierValues = Object.values(ModelTier)

package/src/connect/session/types.ts

@@ -0,0 +1,81 @@
+import type {
+  ConnectExecutor, ConnectHarness, ConnectLlm, ConnectSessionStatus, ConnectTarget, ConnectTransport, ModelTier
+} from '../consts.js'
+
+/**
+ * What a parent agent can do, as it reports itself.
+ *
+ * `tiers` is what decides whether the local-LLM mode is usable at all: a parent that names no
+ * model for a tier still gets tasks, clamped to the nearest tier it does offer.
+ */
+export interface ConnectCapabilities {
+  harness: ConnectHarness
+  /** Tier → the parent's own name for the model it will run that tier on. Display only. */
+  tiers: Partial<Record<ModelTier, string>>
+  /** Whether the parent can run a task in an isolated subagent rather than its own conversation. */
+  subagents: boolean
+  /** Whether the parent can ask for low reasoning effort explicitly. */
+  effortControl: boolean
+  /** Which operation kinds this connector will execute. */
+  executors: ConnectExecutor[]
+  /** What the local machine has, learned from the configure op. Absent until one has run. */
+  services?: ConnectServices
+}
+
+/** What a local machine actually provides. Reported by the connector, never assumed. */
+export interface ConnectServices {
+  db: boolean
+  valkey: boolean
+}
+
+export interface ConnectSession {
+  id?: string
+  profileId: string
+  entityId: string
+  projectId?: string
+  /** The absolute directory the target lives in, for a local target. Identity for supersede. */
+  projectDir?: string
+  target: ConnectTarget
+  llm: ConnectLlm
+  harness: ConnectHarness
+  clientVersion: string
+  capabilities: ConnectCapabilities
+  status: ConnectSessionStatus
+  /** How the connector is receiving operations right now. */
+  transport?: ConnectTransport
+  openedAt: Date
+  lastSeenAt: Date
+  closedAt?: Date
+  createdAt: Date
+  updatedAt?: Date
+}
+
+/** What a connector asks for when it attaches. */
+export interface ConnectSessionOpen {
+  projectId?: string
+  projectDir?: string
+  target: ConnectTarget
+  harness: ConnectHarness
+  clientVersion: string
+  capabilities: ConnectCapabilities
+}
+
+export interface ConnectSessionParams {
+  sessionId: string
+}
+
+export interface ConnectSessionView {
+  id: string
+  target: ConnectTarget
+  llm: ConnectLlm
+  projectId?: string
+  status: ConnectSessionStatus
+  /** Operations waiting for this session right now. */
+  pending: number
+  expiresAt: string
+}
+
+export interface ConnectPullQuery {
+  /** Seconds to wait before answering; clamped to the pull ceiling. */
+  wait?: number
+}

package/src/connect/settings/types.ts

@@ -0,0 +1,52 @@
+import type { ConnectLlm } from '../consts.js'
+
+/** The per-profile connector preference. */
+export interface ConnectProfileSettings {
+  llmMode: ConnectLlm
+}
+
+export interface ConnectProfileSettingsView extends ConnectProfileSettings {
+  /** Whether the organization's plan allows the local-LLM mode at all. */
+  canUseLocal: boolean
+  /**
+   * The profile's preference for who performs a CONVERSION's model calls.
+   *
+   * Its own setting rather than a reading of `llmMode`, because the two answer for different
+   * work: a conversion reads somebody else's whole repository, which is the one case where handing
+   * the inference to the parent agent is the cheap default rather than the experimental option.
+   *
+   * OPTIONAL: the two converter fields are answered by a platform build that does not exist yet,
+   * and this package is consumed by the platform through a workspace link rather than a published
+   * range — a required field here is a compile error in every handler that already returns this
+   * view. Tightened to required once the platform's conversion handlers fill them.
+   */
+  converterLlmMode?: ConnectLlm
+  /** Whether this caller may run a conversion's model calls on the parent agent. */
+  canUseConverterLocal?: boolean
+}
+
+export interface ConnectLlmBody {
+  llmMode: ConnectLlm
+}
+
+/** The per-project override, and what it resolves to. */
+export interface ConnectProjectSettings {
+  /** `null` means "inherit the profile setting". */
+  llmMode: ConnectLlm | null
+  effective: ConnectLlm
+  canUseLocal: boolean
+  /**
+   * The project's converter override; `null` inherits the profile's.
+   *
+   * Optional on the same forward-compatibility grounds as
+   * {@link ConnectProfileSettingsView.converterLlmMode} — absent from an answer written before the
+   * platform's conversion handlers land, and never to be read as a value.
+   */
+  converterLlmMode?: ConnectLlm | null
+  /** What the override, the profile and the platform's own floor actually resolve to. */
+  converterEffective?: ConnectLlm
+}
+
+export interface ConnectProjectLlmBody {
+  llmMode: ConnectLlm | null
+}

package/src/consts.ts

@@ -35,3 +35,20 @@ export const metadataSecrets = [
   'dbAppPassword',
   'valkeyPassword',
 ] satisfies (keyof SlotSecretMetadata)[]
+
+/**
+ * The build-time environment keys a generated application reads its branding from.
+ *
+ * Named here, once, because two processes emit them — the publisher for the preview and the agent
+ * for a production publish — and a key spelled differently in one of them produces an application
+ * that silently falls back to its defaults with nothing anywhere reporting it.
+ */
+export const BRANDING_ENV_KEYS = [
+  'BRANDING_COPYRIGHT',
+  'BRANDING_ORGANIZATION',
+  'BRANDING_TERMS_URL',
+  'BRANDING_PRIVACY_URL',
+  'BRANDING_CREDIT',
+  'BRANDING_PRODUCT',
+  'BRANDING_GOOGLE_TAG',
+] as const

package/src/convert/analysis/types.ts

@@ -0,0 +1,89 @@
+import type { ProjectArea } from '../../areas/consts.js'
+import type { StoryKind } from '../../ba/consts.js'
+import type { PurposeEvidenceSource, TaxonomyKind } from '../consts.js'
+import type { OriginProof } from '../types.js'
+
+export interface PurposeInference {
+  purpose: string
+  audience: string
+  source: PurposeEvidenceSource
+  confidence: number
+  evidence: OriginProof[]
+}
+
+/** A flow the ORIGIN implements, before it is turned into stories. */
+export interface OriginFlow {
+  id: string
+  name: string
+  actor: string
+  area: ProjectArea
+  steps: string[]
+  /** Whether the extracted story list covers it. An uncovered flow is a gap the user is shown. */
+  covered: boolean
+  kind: 'ui' | 'job' | 'cli'
+  proofs: OriginProof[]
+}
+
+/** One entry of the restored story list, in the order the records are created in. */
+export interface ConversionStoryRef {
+  code: string
+  story: string
+  area: ProjectArea
+  kind: ConversionStoryKind
+  ordinal: number
+}
+
+/**
+ * A restored story with the origin code that proves it.
+ *
+ * `complexity` is what the per-story price band is scaled by — derived from the proofs and the
+ * algorithms, never asked of a model, so two runs over the same extraction price identically.
+ */
+export interface StoryProof {
+  code: string
+  narrative: string
+  specification: string
+  ux: string
+  ui: string
+  proofs: OriginProof[]
+  algorithms: { name: string, steps: string[], proof: OriginProof }[]
+  complexity: number
+}
+
+export interface AreaAlignment {
+  areas: {
+    area: ProjectArea
+    roles: string[]
+    permissions: string[]
+    stories: string[]
+  }[]
+  /** Roles or permissions no area claimed. Recorded; never silently dropped. */
+  unmapped: string[]
+}
+
+/** The machine-readable graph the manager's conversion diagram is drawn from. */
+export interface StructureSummary {
+  nodes: { id: string, label: string, kind: TaxonomyKind | 'package' | 'area' }[]
+  edges: { from: string, to: string, label?: string }[]
+}
+
+export interface OriginFlowList {
+  flows: OriginFlow[]
+}
+
+/** What the origin's styles say about its design, in the terms the target's theme is written in. */
+export interface DesignInference {
+  concept: string
+  palette: string[]
+  radius?: string
+  font?: string
+}
+
+/**
+ * What KIND of story a conversion produced.
+ *
+ * The analysis half of a conversion produces exactly the two kinds an ordinary initialization
+ * does; a conversion adds one more — a `coverage` story, written so an area the origin serves but
+ * the flow never reaches still has something in it.
+ */
+export type ConversionStoryKind = StoryKind | 'coverage'

package/src/convert/census/consts.local.ts

@@ -0,0 +1,120 @@
+import { FileClass } from '../consts.js'
+
+/**
+ * Extension → class, for the extensions that decide a file on their own.
+ *
+ * Deliberately not exhaustive: a path rule below overrides it wherever the location says more than
+ * the tail does (a `.ts` under `tests/` is a test, a `.json` under `seed/` is data).
+ */
+export const EXT_CLASS: Record<string, FileClass> = {
+  ts: FileClass.Source, tsx: FileClass.Source, js: FileClass.Source, jsx: FileClass.Source,
+  mjs: FileClass.Source, cjs: FileClass.Source, mts: FileClass.Source, cts: FileClass.Source,
+  vue: FileClass.Source, svelte: FileClass.Source, java: FileClass.Source, kt: FileClass.Source,
+  kts: FileClass.Source, go: FileClass.Source, py: FileClass.Source, rb: FileClass.Source,
+  php: FileClass.Source, cs: FileClass.Source, ex: FileClass.Source, exs: FileClass.Source,
+  rs: FileClass.Source, sql: FileClass.Source, sh: FileClass.Source,
+
+  css: FileClass.Style, scss: FileClass.Style, sass: FileClass.Style, less: FileClass.Style,
+  styl: FileClass.Style,
+
+  md: FileClass.Doc, mdx: FileClass.Doc, rst: FileClass.Doc, adoc: FileClass.Doc,
+  txt: FileClass.Doc,
+
+  json: FileClass.Config, yaml: FileClass.Config, yml: FileClass.Config, toml: FileClass.Config,
+  ini: FileClass.Config, env: FileClass.Config, properties: FileClass.Config,
+  xml: FileClass.Config, conf: FileClass.Config,
+
+  html: FileClass.Template, htm: FileClass.Template, hbs: FileClass.Template,
+  ejs: FileClass.Template, pug: FileClass.Template, twig: FileClass.Template,
+  erb: FileClass.Template, jinja: FileClass.Template, j2: FileClass.Template,
+
+  csv: FileClass.Data, tsv: FileClass.Data, ndjson: FileClass.Data, jsonl: FileClass.Data,
+  parquet: FileClass.Data, dump: FileClass.Data,
+
+  png: FileClass.Binary, jpg: FileClass.Binary, jpeg: FileClass.Binary, gif: FileClass.Binary,
+  webp: FileClass.Binary, ico: FileClass.Binary, pdf: FileClass.Binary, zip: FileClass.Binary,
+  gz: FileClass.Binary, tar: FileClass.Binary, woff: FileClass.Binary, woff2: FileClass.Binary,
+  ttf: FileClass.Binary, otf: FileClass.Binary, mp4: FileClass.Binary, mp3: FileClass.Binary,
+  wasm: FileClass.Binary, jar: FileClass.Binary, so: FileClass.Binary, dll: FileClass.Binary,
+}
+
+/** Exact basenames that are a package manifest whatever their extension says. */
+export const MANIFEST_NAMES = [
+  'package.json', 'deno.json', 'pom.xml', 'build.gradle', 'build.gradle.kts',
+  'settings.gradle', 'settings.gradle.kts', 'go.mod', 'cargo.toml', 'pyproject.toml',
+  'requirements.txt', 'pipfile', 'composer.json', 'gemfile', 'mix.exs',
+]
+
+/** Exact basenames that are a lockfile — never read, never counted as source. */
+export const LOCK_NAMES = [
+  'bun.lock', 'bun.lockb', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', 'go.sum',
+  'cargo.lock', 'composer.lock', 'gemfile.lock', 'poetry.lock', 'pipfile.lock', 'mix.lock',
+]
+
+/**
+ * Path segments whose contents are produced by a build and say nothing about the application.
+ *
+ * `bin` is deliberately absent though `obj` is here: it is .NET/Java output in two of the nine
+ * ecosystems the converter reads and a real entrypoint directory in the rest (`bin/cli.ts`,
+ * `bin/console`, `bin/rails`), and this function is handed one path with no tree around it to
+ * tell the two apart. Dropping those entrypoints out of every source listing is the worse error.
+ */
+export const GENERATED_SEGMENTS = [
+  'node_modules', 'dist', 'build', 'out', 'target', 'vendor', '.next', '.nuxt', '.svelte-kit',
+  '.turbo', '.gradle', '__pycache__', 'coverage', '.venv', 'obj',
+]
+
+/** Path segments that make a file a test wherever its extension would have said otherwise. */
+export const TEST_SEGMENTS = ['test', 'tests', '__tests__', 'spec', 'specs', 'e2e']
+
+/**
+ * The classes a seed or dump LOCATION is allowed to override.
+ *
+ * A seed directory says what a file holds, not what language it is written in — so it reclassifies
+ * a payload and never a program. `seed/users.json` is data; `src/seedUsers.ts` is the code that
+ * loads it, and `src/exportReport.ts` is a screen, and pushing either into the data budget takes
+ * real source out of the census's reach.
+ */
+export const DATA_OVERRIDABLE: FileClass[] = [
+  FileClass.Data, FileClass.Config, FileClass.Binary, FileClass.Unknown,
+]
+
+/**
+ * The extensions that are as often a dump as they are a program.
+ *
+ * A `.sql` under `migrations/` is schema somebody wrote and a coder has to reproduce; the same
+ * tail under `dumps/` is an export nothing should read into a prompt. The location is the only
+ * thing that separates them, so it outranks the tail for these and for no other language.
+ */
+export const DATA_AMBIGUOUS_EXT = ['sql']
+
+/**
+ * Extensions whose tail already answers the binary question, either way.
+ *
+ * Deliberately two lists and not one with a default: an extension the census has never seen must
+ * be READ rather than guessed at, because a repository nobody here wrote carries tails nobody
+ * here chose. Nothing in either list is a guess about content — a `.ts` holding a NUL byte is a
+ * corrupt file, and a `.png` that is not binary is not a `.png`.
+ */
+export const TEXT_EXTENSIONS: readonly string[] = [
+  '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.json', '.jsonc',
+  '.md', '.mdx', '.txt', '.css', '.scss', '.sass', '.less', '.html', '.htm', '.xml', '.svg',
+  '.yml', '.yaml', '.toml', '.ini', '.env', '.sh', '.bash', '.zsh', '.sql', '.graphql', '.gql',
+  '.py', '.rb', '.go', '.rs', '.java', '.kt', '.php', '.cs', '.c', '.h', '.cpp', '.hpp', '.swift',
+  '.vue', '.svelte', '.astro', '.lock', '.csv',
+]
+
+export const BINARY_EXTENSIONS: readonly string[] = [
+  '.png', '.jpg', '.jpeg', '.gif', '.webp', '.avif', '.bmp', '.ico', '.icns', '.tiff',
+  '.mp3', '.mp4', '.wav', '.ogg', '.webm', '.mov', '.avi',
+  '.woff', '.woff2', '.ttf', '.otf', '.eot',
+  '.pdf', '.zip', '.gz', '.tgz', '.bz2', '.xz', '.7z', '.rar', '.tar',
+  '.wasm', '.node', '.so', '.dylib', '.dll', '.exe', '.bin', '.class', '.jar',
+  '.db', '.sqlite', '.sqlite3',
+]
+
+/** Path segments and name fragments that mark bulk data — an export, not the app's own data. */
+export const BULK_HINTS = ['dump', 'dumps', 'export', 'exports', 'backup', 'backups', 'snapshot', 'archive']
+
+/** Path segments that mark seed data — what the application needs in order to make sense. */
+export const SEED_HINTS = ['seed', 'seeds', 'fixture', 'fixtures', 'sample', 'samples', 'demo-data']