@owlmeans/viable-common 0.0.44 → 0.0.45

package/build/convert/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/convert/docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,eAAO,MAAM,yBAAyB,QAAO,mBAS5C,CAAA;AAED,eAAO,MAAM,mBAAmB,qBAA8B,CAAA"}

package/build/convert/docs.js

@@ -0,0 +1,9 @@
+import { CONVERSION_SEED_DATA_DIR, CONVERSION_SEED_DIR, CONVERSION_STORY_DIR } from './consts.js';
+export const createConversionDocHelper = () => {
+    const conversionStoryDoc = (code) => `${CONVERSION_STORY_DIR}/${code}.md`;
+    const conversionSeedDoc = (name) => `${CONVERSION_SEED_DIR}/${name}.md`;
+    const conversionSeedData = (name, ext) => `${CONVERSION_SEED_DATA_DIR}/${name}.${ext}`;
+    return { conversionStoryDoc, conversionSeedDoc, conversionSeedData };
+};
+export const conversionDocHelper = createConversionDocHelper();
+//# sourceMappingURL=docs.js.map

package/build/convert/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/convert/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAwB,EAAE;IACjE,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,oBAAoB,IAAI,IAAI,KAAK,CAAA;IAEzF,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,mBAAmB,IAAI,IAAI,KAAK,CAAA;IAEvF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CAC/D,GAAG,wBAAwB,IAAI,IAAI,IAAI,GAAG,EAAE,CAAA;IAE9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAA;AACtE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAA"}

package/build/convert/estimate/types.d.ts

@@ -0,0 +1,77 @@
+import type { ModelRole } from '../../execution/consts.js';
+import type { ConversionStage, EstimateSlice } from '../consts.js';
+/**
+ * One row of a stage's role plan — what the estimator believes a step will spend.
+ *
+ * Data rather than a measurement: the plan says which slices of the origin a step reads, how many
+ * calls it makes and what it writes back, and the estimator projects tokens from the census. A
+ * step that is per-story is multiplied by the story count instead of run once.
+ */
+export interface RolePlanEntry {
+    step: string;
+    role: ModelRole;
+    slices: EstimateSlice[];
+    /** What share of the named slices this step actually reads. */
+    factor: number;
+    calls: number;
+    /** Fixed input tokens per call — the persona, the framing, the schema. */
+    overhead: number;
+    /** Expected output tokens per call. */
+    output: number;
+    perStory?: boolean;
+}
+export interface RoleEstimate {
+    role: ModelRole;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    steps: string[];
+}
+/**
+ * What one stage is expected to cost, as the platform stores it on the conversion record.
+ *
+ * Priced on the agent, where the model presets and the run mode are: a DELEGATED conversion runs
+ * its model calls on the parent agent and costs the platform nothing, so `usd` is zero and
+ * `delegated` says why. `basis` is kept so a user can see what the number was projected from
+ * rather than being handed a figure with no provenance.
+ */
+export interface ConversionEstimate {
+    stage: ConversionStage;
+    version: number;
+    roles: RoleEstimate[];
+    inputTokens: number;
+    outputTokens: number;
+    usd: number;
+    /** @deprecated Credits are USD at the reference rate now — read `usd`. Kept for records stored before the change. */
+    credits?: number;
+    delegated: boolean;
+    basis: {
+        files: number;
+        bytes: number;
+        storyCount?: number;
+        sampleRatio: number;
+        retryFactor: number;
+    };
+    computedAt: string;
+}
+/**
+ * The per-story band shown before the implementation stage.
+ *
+ * A range, because a story's cost is set by how much code it turns out to need — which is exactly
+ * what nothing knows before it is written. Shown with the disclaimer that says so.
+ */
+export interface StoryEstimateBand {
+    minUsd: number;
+    maxUsd: number;
+    /** @deprecated Credits are USD at the reference rate now — read `minUsd`. Kept for records stored before the change. */
+    minCredits?: number;
+    /** @deprecated Credits are USD at the reference rate now — read `maxUsd`. Kept for records stored before the change. */
+    maxCredits?: number;
+    perStory: {
+        code: string;
+        complexity: number;
+        minUsd: number;
+        maxUsd: number;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/convert/estimate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/convert/estimate/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAA;IAChB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,eAAe,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,qHAAqH;IACrH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,wHAAwH;IACxH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wHAAwH;IACxH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACjF"}

package/build/convert/estimate/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/convert/estimate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/convert/estimate/types.ts"],"names":[],"mappings":""}

package/build/convert/estimate.d.ts

@@ -0,0 +1,11 @@
+import type { StoryProof } from './analysis/types.js';
+/**
+ * How much work re-implementing a story is, as a multiplier on the per-story price band.
+ *
+ * Derived from what the extraction found, never asked of a model: a story backed by a handful of
+ * proofs and no algorithm is ordinary CRUD, one that carries described algorithms is business
+ * logic somebody has to reproduce. Two runs over the same extraction therefore price identically,
+ * which is the point — a band that moved between two viewings of the same screen would be noise.
+ */
+export declare const storyComplexity: (proof: Pick<StoryProof, 'proofs' | 'algorithms'>) => number;
+//# sourceMappingURL=estimate.d.ts.map

package/build/convert/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/convert/estimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,UAAW,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,YAAY,CAAC,KAAG,MAQlF,CAAA"}

package/build/convert/estimate.js

@@ -0,0 +1,18 @@
+/**
+ * How much work re-implementing a story is, as a multiplier on the per-story price band.
+ *
+ * Derived from what the extraction found, never asked of a model: a story backed by a handful of
+ * proofs and no algorithm is ordinary CRUD, one that carries described algorithms is business
+ * logic somebody has to reproduce. Two runs over the same extraction therefore price identically,
+ * which is the point — a band that moved between two viewings of the same screen would be noise.
+ */
+export const storyComplexity = (proof) => {
+    const proofs = proof.proofs?.length ?? 0;
+    const algorithms = proof.algorithms?.length ?? 0;
+    if (algorithms > 1 || proofs > 8)
+        return 2;
+    if (algorithms > 0 || proofs > 3)
+        return 1.5;
+    return 1;
+};
+//# sourceMappingURL=estimate.js.map

package/build/convert/estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/convert/estimate.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAgD,EAAU,EAAE;IAC1F,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAA;IAEhD,IAAI,UAAU,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAA;IAC1C,IAAI,UAAU,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IAE5C,OAAO,CAAC,CAAA;AACV,CAAC,CAAA"}

package/build/convert/helpers.d.ts

@@ -1,91 +1,27 @@
-import { ConversionDecision, ConversionStage, EntropyClass, FileClass, SizeClass } from './consts.js';
-import type { OriginCard, StoryProof } from './types.js';
-/**
- * Pure, deterministic derivations over the conversion vocabulary.
- *
- * Everything here answers the same way for the same input, in every runtime, forever — which is
- * what makes the documents a conversion writes byte-stable across two runs, and therefore what
- * makes the prompt cache prefix they are injected into actually hit. Nothing in this file reads a
- * file, calls a model or looks at a clock.
- */
-/** Which {@link SizeClass} a byte count falls in. Boundaries are exclusive upper bounds. */
+import type { ConversionDecision, ConversionStage, EntropyClass, FileClass, SizeClass } from './consts.js';
+import type { OriginCard } from './origin/types.js';
+/** @deprecated compat:factory-refactor — use `censusHelper.sizeClassOf(…)` */
 export declare const sizeClassOf: (bytes: number) => SizeClass;
-/**
- * What one file of the origin is.
- *
- * Location outranks the tail wherever it says more — a `.ts` under `__tests__/` is a test, a
- * `.json` under `seed/` is data — but only where it says more. The seed/dump rule therefore runs
- * AFTER the extension table and applies only to {@link DATA_OVERRIDABLE}: asked first, it answered
- * `Data` for every path merely containing the word (`tests/fixtures/user.ts`, `src/seedUsers.ts`,
- * `src/exportReport.ts`), which is the census's source budget spent on the wrong files twice over.
- */
+/** @deprecated compat:factory-refactor — use `censusHelper.fileClassOf(…)` */
 export declare const fileClassOf: (path: string, ext: string) => FileClass;
-/**
- * The binary verdict a path already carries, or `null` for a file that has to be probed.
- *
- * The three executors that walk a tree — the library-local helper, the publisher and the connector
- * SDK — must answer the same verdict for the same file, and a probe alone does not: a small `.ico`
- * with no NUL in its first bytes reads as text, so a census run on a laptop and the same census
- * run in the slot disagreed about the same repository. The tail is asked first and the probe only
- * where the tail says nothing, which is also why the probe is affordable at census scale — the
- * extensions above are the bulk of any repository.
- *
- * The extension is taken exactly the way `path.extname` takes it, because two of the three callers
- * used to: the last dot of the last SEGMENT, and nothing for a name with no dot or for a dotfile.
- */
+/** @deprecated compat:factory-refactor — use `censusHelper.binaryByExtension(…)` */
 export declare const binaryByExtension: (path: string) => boolean | null;
-/**
- * How usable a file's head is as evidence.
- *
- * The printable ratio over the sampled head, and nothing cleverer: the question is only whether a
- * model can read it. A minified bundle is printable and useless, so a second rule catches the
- * shape that gives it away — very long lines with almost no whitespace.
- */
+/** @deprecated compat:factory-refactor — use `censusHelper.entropyClassOf(…)` */
 export declare const entropyClassOf: (head: string) => EntropyClass;
+/** @deprecated compat:factory-refactor — use `censusHelper.isBulkPath(…)` */
 export declare const isBulkPath: (path: string) => boolean;
+/** @deprecated compat:factory-refactor — use `censusHelper.isSeedPath(…)` */
 export declare const isSeedPath: (path: string) => boolean;
-/**
- * How much work re-implementing a story is, as a multiplier on the per-story price band.
- *
- * Derived from what the extraction found, never asked of a model: a story backed by a handful of
- * proofs and no algorithm is ordinary CRUD, one that carries described algorithms is business
- * logic somebody has to reproduce. Two runs over the same extraction therefore price identically,
- * which is the point — a band that moved between two viewings of the same screen would be noise.
- */
-export declare const storyComplexity: (proof: Pick<StoryProof, 'proofs' | 'algorithms'>) => number;
-/**
- * The stage after this one.
- *
- * The last stage answers with itself: there is nothing after implementation, and returning
- * `undefined` would only move the same check to every call site.
- */
+/** @deprecated compat:factory-refactor — use `conversionStageHelper.stageAfter(…)` */
 export declare const stageAfter: (stage: ConversionStage) => ConversionStage;
-/**
- * The decision that ADVANCES out of a stage.
- *
- * Implementation's is {@link ConversionDecision.Leave}, because a finished conversion has nothing
- * further to run and leaving it as it stands is the ordinary outcome rather than an abandonment.
- */
+/** @deprecated compat:factory-refactor — use `conversionStageHelper.decisionFor(…)` */
 export declare const decisionFor: (stage: ConversionStage) => ConversionDecision;
-/**
- * Whether a conversion at `from` may enter `to`.
- *
- * The same stage is legal — that is a retry. The next one is legal. Nothing else is: every stage
- * reads the documents the stage before it wrote, so skipping one means running against documents
- * that were never produced, and going back means overwriting the record a later stage is built on.
- */
-export declare const canEnter: (from: ConversionStage, to: ConversionStage) => boolean;
-/** The size of the rendered origin card, so a composer can trim before it exceeds its ceiling. */
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originCardChars(…)` */
 export declare const originCardChars: (card: OriginCard) => number;
-/** Whether a rendered card still fits the budget every coder prompt carries it in. */
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originCardFits(…)` */
 export declare const originCardFits: (card: OriginCard) => boolean;
-/** Whether a target-relative path names the origin tree, or something inside it. */
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.isOriginPath(…)` */
 export declare const isOriginPath: (path: string) => boolean;
-/**
- * A path inside the origin tree, from a path relative to the origin's own root.
- *
- * Idempotent: a path already under the origin comes back unchanged, so a caller that has lost
- * track of which side of the move it holds cannot produce `__viable_converted/__viable_converted/`.
- */
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originPath(…)` */
 export declare const originPath: (relative: string) => string;
 //# sourceMappingURL=helpers.d.ts.map

package/build/convert/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/convert/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACa,kBAAkB,EAAE,eAAe,EAC/B,YAAY,EAAE,SAAS,EAAyB,SAAS,EAEhF,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGxD;;;;;;;GAOG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,SAO3C,CAAA;AAOD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,SAAU,MAAM,OAAO,MAAM,KAAG,SAsBvD,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,OAAO,GAAG,IAO1D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,YAsB7C,CAAA;AAUD,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAAwC,CAAA;AAElF,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAAwC,CAAA;AAElF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,UAAW,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,YAAY,CAAC,KAAG,MAQlF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,UAAW,eAAe,KAAG,eAInD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,UAAW,eAAe,KAAG,kBAOpD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,SAAU,eAAe,MAAM,eAAe,KAAG,OAMrE,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,SAAU,UAAU,KAAG,MAQM,CAAA;AAEzD,sFAAsF;AACtF,eAAO,MAAM,cAAc,SAAU,UAAU,KAAG,OACF,CAAA;AAEhD,oFAAoF;AACpF,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,OACkC,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,UAAU,aAAc,MAAM,KAAG,MAM7C,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/convert/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,8EAA8E;AAC9E,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,SAA4C,CAAA;AAExF,8EAA8E;AAC9E,eAAO,MAAM,WAAW,SAAU,MAAM,OAAO,MAAM,KAAG,SAAgD,CAAA;AAExG,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,OAAO,GAAG,IAA4C,CAAA;AAEvG,iFAAiF;AACjF,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,YAAiD,CAAA;AAE/F,6EAA6E;AAC7E,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAAwC,CAAA;AAElF,6EAA6E;AAC7E,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAAwC,CAAA;AAElF,sFAAsF;AACtF,eAAO,MAAM,UAAU,UAAW,eAAe,KAAG,eAA0D,CAAA;AAE9G,uFAAuF;AACvF,eAAO,MAAM,WAAW,UAAW,eAAe,KAAG,kBAA8D,CAAA;AAEnH,4FAA4F;AAC5F,eAAO,MAAM,eAAe,SAAU,UAAU,KAAG,MAAsD,CAAA;AAEzG,2FAA2F;AAC3F,eAAO,MAAM,cAAc,SAAU,UAAU,KAAG,OAAsD,CAAA;AAExG,yFAAyF;AACzF,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,OAAoD,CAAA;AAEhG,uFAAuF;AACvF,eAAO,MAAM,UAAU,aAAc,MAAM,KAAG,MAAqD,CAAA"}

package/build/convert/helpers.js

@@ -1,200 +1,28 @@
-import { ConversionDecision, ConversionStage, CONVERSION_STAGE_ORDER, CONVERTED_ORIGIN_DIR, EntropyClass, FileClass, ORIGIN_CARD_MAX_CHARS, SizeClass, SIZE_CLASS_BOUNDS } from './consts.js';
-import { BINARY_EXTENSIONS, BULK_HINTS, DATA_AMBIGUOUS_EXT, DATA_OVERRIDABLE, EXT_CLASS, GENERATED_SEGMENTS, LOCK_NAMES, MANIFEST_NAMES, SEED_HINTS, TEST_SEGMENTS, TEXT_EXTENSIONS } from './consts.local.js';
-/**
- * Pure, deterministic derivations over the conversion vocabulary.
- *
- * Everything here answers the same way for the same input, in every runtime, forever — which is
- * what makes the documents a conversion writes byte-stable across two runs, and therefore what
- * makes the prompt cache prefix they are injected into actually hit. Nothing in this file reads a
- * file, calls a model or looks at a clock.
- */
-/** Which {@link SizeClass} a byte count falls in. Boundaries are exclusive upper bounds. */
-export const sizeClassOf = (bytes) => {
-    if (bytes < SIZE_CLASS_BOUNDS[SizeClass.Tiny])
-        return SizeClass.Tiny;
-    if (bytes < SIZE_CLASS_BOUNDS[SizeClass.Small])
-        return SizeClass.Small;
-    if (bytes < SIZE_CLASS_BOUNDS[SizeClass.Medium])
-        return SizeClass.Medium;
-    if (bytes < SIZE_CLASS_BOUNDS[SizeClass.Large])
-        return SizeClass.Large;
-    return SizeClass.Huge;
-};
-const segmentsOf = (path) => path.split('/').filter(part => part !== '');
-const hasSegment = (path, of) => segmentsOf(path).some(part => of.includes(part.toLowerCase()));
-/**
- * What one file of the origin is.
- *
- * Location outranks the tail wherever it says more — a `.ts` under `__tests__/` is a test, a
- * `.json` under `seed/` is data — but only where it says more. The seed/dump rule therefore runs
- * AFTER the extension table and applies only to {@link DATA_OVERRIDABLE}: asked first, it answered
- * `Data` for every path merely containing the word (`tests/fixtures/user.ts`, `src/seedUsers.ts`,
- * `src/exportReport.ts`), which is the census's source budget spent on the wrong files twice over.
- */
-export const fileClassOf = (path, ext) => {
-    const lower = path.toLowerCase();
-    const base = segmentsOf(lower).pop() ?? lower;
-    const tail = (ext.startsWith('.') ? ext.slice(1) : ext).toLowerCase();
-    if (LOCK_NAMES.includes(base))
-        return FileClass.Lock;
-    if (hasSegment(lower, GENERATED_SEGMENTS))
-        return FileClass.Generated;
-    if (MANIFEST_NAMES.includes(base))
-        return FileClass.Manifest;
-    if (hasSegment(lower, TEST_SEGMENTS) || base.includes('.test.') || base.includes('.spec.')) {
-        return FileClass.Test;
-    }
-    if (base.startsWith('.env'))
-        return FileClass.Config;
-    const byExt = EXT_CLASS[tail] ?? FileClass.Unknown;
-    if ((DATA_OVERRIDABLE.includes(byExt) || DATA_AMBIGUOUS_EXT.includes(tail))
-        && (isSeedPath(lower) || isBulkPath(lower))) {
-        return FileClass.Data;
-    }
-    return byExt;
-};
-/**
- * The binary verdict a path already carries, or `null` for a file that has to be probed.
- *
- * The three executors that walk a tree — the library-local helper, the publisher and the connector
- * SDK — must answer the same verdict for the same file, and a probe alone does not: a small `.ico`
- * with no NUL in its first bytes reads as text, so a census run on a laptop and the same census
- * run in the slot disagreed about the same repository. The tail is asked first and the probe only
- * where the tail says nothing, which is also why the probe is affordable at census scale — the
- * extensions above are the bulk of any repository.
- *
- * The extension is taken exactly the way `path.extname` takes it, because two of the three callers
- * used to: the last dot of the last SEGMENT, and nothing for a name with no dot or for a dotfile.
- */
-export const binaryByExtension = (path) => {
-    const base = segmentsOf(path).pop() ?? path;
-    const dot = base.lastIndexOf('.');
-    if (dot < 1)
-        return null;
-    const ext = base.slice(dot).toLowerCase();
-    return TEXT_EXTENSIONS.includes(ext) ? false : BINARY_EXTENSIONS.includes(ext) ? true : null;
-};
-/**
- * How usable a file's head is as evidence.
- *
- * The printable ratio over the sampled head, and nothing cleverer: the question is only whether a
- * model can read it. A minified bundle is printable and useless, so a second rule catches the
- * shape that gives it away — very long lines with almost no whitespace.
- */
-export const entropyClassOf = (head) => {
-    if (head.length < 1)
-        return EntropyClass.Text;
-    let printable = 0;
-    let whitespace = 0;
-    for (const char of head) {
-        const code = char.codePointAt(0) ?? 0;
-        if (code === 9 || code === 10 || code === 13 || code === 32) {
-            ++whitespace;
-            ++printable;
-        }
-        else if (code >= 32 && code !== 127) {
-            ++printable;
-        }
-    }
-    const ratio = printable / head.length;
-    if (ratio < 0.85)
-        return EntropyClass.Opaque;
-    // Prose, code and markup all break lines and indent. A body that does neither is minified,
-    // encoded or packed — printable, and not something a model can reason over.
-    if (whitespace / head.length < 0.05)
-        return EntropyClass.Dense;
-    return EntropyClass.Text;
-};
-const matchesHint = (path, hints) => {
-    const lower = path.toLowerCase();
-    if (hasSegment(lower, hints))
-        return true;
-    const base = segmentsOf(lower).pop() ?? lower;
-    return hints.some(hint => base.includes(hint));
-};
-export const isBulkPath = (path) => matchesHint(path, BULK_HINTS);
-export const isSeedPath = (path) => matchesHint(path, SEED_HINTS);
-/**
- * How much work re-implementing a story is, as a multiplier on the per-story price band.
- *
- * Derived from what the extraction found, never asked of a model: a story backed by a handful of
- * proofs and no algorithm is ordinary CRUD, one that carries described algorithms is business
- * logic somebody has to reproduce. Two runs over the same extraction therefore price identically,
- * which is the point — a band that moved between two viewings of the same screen would be noise.
- */
-export const storyComplexity = (proof) => {
-    const proofs = proof.proofs?.length ?? 0;
-    const algorithms = proof.algorithms?.length ?? 0;
-    if (algorithms > 1 || proofs > 8)
-        return 2;
-    if (algorithms > 0 || proofs > 3)
-        return 1.5;
-    return 1;
-};
-/**
- * The stage after this one.
- *
- * The last stage answers with itself: there is nothing after implementation, and returning
- * `undefined` would only move the same check to every call site.
- */
-export const stageAfter = (stage) => {
-    const at = CONVERSION_STAGE_ORDER.indexOf(stage);
-    return CONVERSION_STAGE_ORDER[at + 1] ?? stage;
-};
-/**
- * The decision that ADVANCES out of a stage.
- *
- * Implementation's is {@link ConversionDecision.Leave}, because a finished conversion has nothing
- * further to run and leaving it as it stands is the ordinary outcome rather than an abandonment.
- */
-export const decisionFor = (stage) => {
-    switch (stage) {
-        case ConversionStage.Intake: return ConversionDecision.Analyze;
-        case ConversionStage.Analysis: return ConversionDecision.Extract;
-        case ConversionStage.Extraction: return ConversionDecision.Implement;
-        default: return ConversionDecision.Leave;
-    }
-};
-/**
- * Whether a conversion at `from` may enter `to`.
- *
- * The same stage is legal — that is a retry. The next one is legal. Nothing else is: every stage
- * reads the documents the stage before it wrote, so skipping one means running against documents
- * that were never produced, and going back means overwriting the record a later stage is built on.
- */
-export const canEnter = (from, to) => {
-    const at = CONVERSION_STAGE_ORDER.indexOf(from);
-    const next = CONVERSION_STAGE_ORDER.indexOf(to);
-    if (at < 0 || next < 0)
-        return false;
-    return next === at || next === at + 1;
-};
-/** The size of the rendered origin card, so a composer can trim before it exceeds its ceiling. */
-export const originCardChars = (card) => [
-    card.stack,
-    card.case,
-    card.purpose,
-    ...card.packages,
-    ...card.entities,
-    ...card.flows,
-    ...card.conventions,
-].reduce((total, part) => total + (part?.length ?? 0), 0);
-/** Whether a rendered card still fits the budget every coder prompt carries it in. */
-export const originCardFits = (card) => originCardChars(card) <= ORIGIN_CARD_MAX_CHARS;
-/** Whether a target-relative path names the origin tree, or something inside it. */
-export const isOriginPath = (path) => path === CONVERTED_ORIGIN_DIR || path.startsWith(`${CONVERTED_ORIGIN_DIR}/`);
-/**
- * A path inside the origin tree, from a path relative to the origin's own root.
- *
- * Idempotent: a path already under the origin comes back unchanged, so a caller that has lost
- * track of which side of the move it holds cannot produce `__viable_converted/__viable_converted/`.
- */
-export const originPath = (relative) => {
-    const path = relative.replace(/^\/+/, '');
-    if (path === '')
-        return CONVERTED_ORIGIN_DIR;
-    if (isOriginPath(path))
-        return path;
-    return `${CONVERTED_ORIGIN_DIR}/${path}`;
-};
+import { censusHelper } from './census.js';
+import { conversionOriginHelper } from './origin.js';
+import { conversionStageHelper } from './stage.js';
+/** @deprecated compat:factory-refactor — use `censusHelper.sizeClassOf(…)` */
+export const sizeClassOf = (bytes) => censusHelper.sizeClassOf(bytes);
+/** @deprecated compat:factory-refactor — use `censusHelper.fileClassOf(…)` */
+export const fileClassOf = (path, ext) => censusHelper.fileClassOf(path, ext);
+/** @deprecated compat:factory-refactor — use `censusHelper.binaryByExtension(…)` */
+export const binaryByExtension = (path) => censusHelper.binaryByExtension(path);
+/** @deprecated compat:factory-refactor — use `censusHelper.entropyClassOf(…)` */
+export const entropyClassOf = (head) => censusHelper.entropyClassOf(head);
+/** @deprecated compat:factory-refactor — use `censusHelper.isBulkPath(…)` */
+export const isBulkPath = (path) => censusHelper.isBulkPath(path);
+/** @deprecated compat:factory-refactor — use `censusHelper.isSeedPath(…)` */
+export const isSeedPath = (path) => censusHelper.isSeedPath(path);
+/** @deprecated compat:factory-refactor — use `conversionStageHelper.stageAfter(…)` */
+export const stageAfter = (stage) => conversionStageHelper.stageAfter(stage);
+/** @deprecated compat:factory-refactor — use `conversionStageHelper.decisionFor(…)` */
+export const decisionFor = (stage) => conversionStageHelper.decisionFor(stage);
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originCardChars(…)` */
+export const originCardChars = (card) => conversionOriginHelper.originCardChars(card);
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originCardFits(…)` */
+export const originCardFits = (card) => conversionOriginHelper.originCardFits(card);
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.isOriginPath(…)` */
+export const isOriginPath = (path) => conversionOriginHelper.isOriginPath(path);
+/** @deprecated compat:factory-refactor — use `conversionOriginHelper.originPath(…)` */
+export const originPath = (relative) => conversionOriginHelper.originPath(relative);
 //# sourceMappingURL=helpers.js.map

package/build/convert/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/convert/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/convert/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAa,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AAExF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,GAAW,EAAa,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAExG,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;AAEvG,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAgB,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAE/F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAElF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AAElF,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAsB,EAAmB,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;AAE9G,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAsB,EAAsB,EAAE,CAAC,qBAAqB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AAEnH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAgB,EAAU,EAAE,CAAC,sBAAsB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AAEzG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAgB,EAAW,EAAE,CAAC,sBAAsB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAExG,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,sBAAsB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;AAEhG,uFAAuF;AACvF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA"}

package/build/convert/index.d.ts

@@ -2,7 +2,21 @@ export * from './consts.js';
 export * from './utils.js';
 export * from './schemas.js';
 export * from './helpers.js';
+export * from './census.js';
+export * from './stage.js';
+export * from './estimate.js';
+export * from './origin.js';
+export * from './docs.js';
 export type * from './types.js';
+export type * from './census/types.js';
+export type * from './detection/types.js';
+export type * from './taxonomy/types.js';
+export type * from './analysis/types.js';
+export type * from './origin/types.js';
+export type * from './estimate/types.js';
+export type * from './record/types.js';
+export type * from './docs/types.js';
+export type * from './stage/types.js';
 /**
  * Declared beside the slot command that produces it and re-exported here, because the census is
  * the only thing that reads a whole tree of them: one declaration, reachable from both barrels

package/build/convert/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/convert/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B;;;;GAIG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/convert/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,kBAAkB,CAAA;AACrC;;;;GAIG;AACH,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA"}

package/build/convert/index.js

@@ -2,4 +2,9 @@ export * from './consts.js';
 export * from './utils.js';
 export * from './schemas.js';
 export * from './helpers.js';
+export * from './census.js';
+export * from './stage.js';
+export * from './estimate.js';
+export * from './origin.js';
+export * from './docs.js';
 //# sourceMappingURL=index.js.map

package/build/convert/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/convert/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/convert/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA"}

package/build/convert/origin/types.d.ts

@@ -0,0 +1,41 @@
+import type { ArchitectureCase, StackId, TaxonomyKind } from '../consts.js';
+/** The origin tree inside a target, and the standing card that describes it. */
+export interface ConversionOriginHelper {
+    /** The size of the rendered origin card, so a composer can trim before it exceeds its ceiling. */
+    originCardChars: (card: OriginCard) => number;
+    /** Whether a rendered card still fits the budget every coder prompt carries it in. */
+    originCardFits: (card: OriginCard) => boolean;
+    /** Whether a target-relative path names the origin tree, or something inside it. */
+    isOriginPath: (path: string) => boolean;
+    /**
+     * A path inside the origin tree, from a path relative to the origin's own root.
+     *
+     * Idempotent: a path already under the origin comes back unchanged, so a caller that has lost
+     * track of which side of the move it holds cannot produce `__viable_converted/__viable_converted/`.
+     */
+    originPath: (relative: string) => string;
+}
+/**
+ * The standing description of the origin every coder prompt carries.
+ *
+ * Capped at {@link ORIGIN_CARD_MAX_CHARS}: it rides on every generation call of the
+ * implementation stage, so its length is multiplied by the number of calls the conversion makes.
+ */
+export interface OriginCard {
+    stack: StackId;
+    case: ArchitectureCase;
+    purpose: string;
+    packages: string[];
+    entities: string[];
+    flows: string[];
+    conventions: string[];
+    chars: number;
+}
+/** One line of the origin→target map the target's own agent memory keeps. */
+export interface OriginMapEntry {
+    origin: string;
+    target?: string;
+    kind: TaxonomyKind;
+    story?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/convert/origin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/convert/origin/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3E,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAA;IAC7C,sFAAsF;IACtF,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAA;IAC7C,oFAAoF;IACpF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACvC;;;;;OAKG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/build/convert/origin/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/convert/origin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/convert/origin/types.ts"],"names":[],"mappings":""}

package/build/convert/origin.d.ts

@@ -0,0 +1,4 @@
+import type { ConversionOriginHelper } from './origin/types.js';
+export declare const createConversionOriginHelper: () => ConversionOriginHelper;
+export declare const conversionOriginHelper: ConversionOriginHelper;
+//# sourceMappingURL=origin.d.ts.map

package/build/convert/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../../src/convert/origin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAc,MAAM,mBAAmB,CAAA;AAE3E,eAAO,MAAM,4BAA4B,QAAO,sBA0B/C,CAAA;AAED,eAAO,MAAM,sBAAsB,wBAAiC,CAAA"}