project-tiny-context-harness 0.8.10 → 0.8.11

package/README.md

@@ -182,7 +182,7 @@ npm ci
 npm run smoke:quickstart
 npm run preview:pack
 cd /path/to/your/test-repo
-npm install -D /path/to/project-tiny-context-harness/tmp/ty-context/source-preview/package/project-tiny-context-harness-0.8.10.tgz
+npm install -D /path/to/project-tiny-context-harness/tmp/ty-context/source-preview/package/project-tiny-context-harness-0.8.11.tgz
 npx --no-install ty-context init --adopt
 make validate-context
 ```
@@ -446,7 +446,7 @@ make validate-harness
 
 The modularity gate is the capability-aware `ty-context check-modularity`. Scoped waivers require `owner`, `introduced_at`, `reason`, `tracking_issue` and `expiry_condition`; unsupported metrics never appear as passing zeroes.
 
-The synchronized local preview tarball is named `project-tiny-context-harness-0.8.10.tgz`.
+The synchronized local preview tarball is named `project-tiny-context-harness-0.8.11.tgz`.
 
 ## Community And Further Reading
 

package/assets/README.md

@@ -180,7 +180,7 @@ The smoke packs the local workspace, installs it into a disposable repo and vali
 
 ```sh
 cd /path/to/your/test-repo
-npm install -D /path/to/project-tiny-context-harness/tmp/ty-context/source-preview/package/project-tiny-context-harness-0.8.10.tgz
+npm install -D /path/to/project-tiny-context-harness/tmp/ty-context/source-preview/package/project-tiny-context-harness-0.8.11.tgz
 npx --no-install ty-context init --adopt
 make validate-context
 ```
@@ -715,7 +715,7 @@ make validate-harness
 
 The modularity gate is `ty-context check-modularity`. Scoped waivers require `owner`, `introduced_at`, `reason`, `tracking_issue` and `expiry_condition`.
 
-`npm run preview:pack` produces a local preview named `project-tiny-context-harness-0.8.10.tgz` under the preview output directory.
+`npm run preview:pack` produces a local preview named `project-tiny-context-harness-0.8.11.tgz` under the preview output directory.
 
 ## Community And Further Reading
 

package/dist/index.d.ts

@@ -2,7 +2,6 @@ export { commands } from "./commands/index.js";
 export { compileDeliveryContract, type CompileDeliveryOptionsV2, } from "./lib/long-task-delivery-compiler.js";
 export { DELIVERY_CONTRACT_FILE, parseDeliveryContract, parseDeliveryContractBundle, } from "./lib/long-task-delivery-parser.js";
 export { evaluateContractBoundary } from "./lib/long-task-boundary-check.js";
-export { publishDesignResourceHandoffBundle, type DesignResourceHandoffBundleOptions, type DesignResourceHandoffBundleResult, } from "./lib/design-resource-handoff-bundle.js";
 export { preflightDesignResourceHandoff } from "./lib/design-resource-handoff-validation.js";
 export { classifyLongTaskRisk, validateRiskProof, } from "./lib/long-task-risk.js";
 export { verifyDeliveryContract } from "./lib/long-task-verifier-v2.js";

package/dist/index.js

@@ -2,7 +2,6 @@ export { commands } from "./commands/index.js";
 export { compileDeliveryContract, } from "./lib/long-task-delivery-compiler.js";
 export { DELIVERY_CONTRACT_FILE, parseDeliveryContract, parseDeliveryContractBundle, } from "./lib/long-task-delivery-parser.js";
 export { evaluateContractBoundary } from "./lib/long-task-boundary-check.js";
-export { publishDesignResourceHandoffBundle, } from "./lib/design-resource-handoff-bundle.js";
 export { preflightDesignResourceHandoff } from "./lib/design-resource-handoff-validation.js";
 export { classifyLongTaskRisk, validateRiskProof, } from "./lib/long-task-risk.js";
 export { verifyDeliveryContract } from "./lib/long-task-verifier-v2.js";

package/dist/lib/design-resource-fact-manifest-validation.d.ts

@@ -1,4 +1,5 @@
 import type { DesignResourceObservableFactManifestV1 } from "./design-resource-fact-manifest-types.js";
-import type { ParsedDesignResourceHandoffInputV1, ParsedDesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+import type { ParsedDesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
 export declare function parseDesignResourceFactManifests(parsed: ParsedDesignResourceHandoffInputV1, contents: Map<string, Buffer>): Map<string, DesignResourceObservableFactManifestV1>;
 export declare function validateDesignResourceFactManifests(parsed: ParsedDesignResourceHandoffV1, contents: Map<string, Buffer>, manifests: Map<string, DesignResourceObservableFactManifestV1>, validateProjection: boolean): void;

package/dist/lib/design-resource-handoff-bundle-draft.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
+import type { DesignResourceHandoffResourceV1, DesignResourceHandoffTargetV1 } from "./design-resource-handoff-types.js";
+type BundleFailure = (code: string, detail: string) => never;
+export interface StagedDesignResourceHandoffDraft {
+    bytes: Buffer;
+    parsed: ParsedDesignResourceHandoffInputV1;
+    target: DesignResourceHandoffTargetV1;
+    manifest_resource: DesignResourceHandoffResourceV1;
+}
+export declare function stageDesignResourceHandoffDraft(repository: string, draftDirectory: string, temporaryDirectory: string, entryName: string, maxBytes: number, fail: BundleFailure): Promise<StagedDesignResourceHandoffDraft>;
+export {};

package/dist/lib/design-resource-handoff-bundle-draft.js

@@ -0,0 +1,38 @@
+import { lstat, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parseDesignResourceHandoffMarkdown } from "./design-resource-handoff-parser.js";
+import { repoRelative } from "./long-task-workspace.js";
+export async function stageDesignResourceHandoffDraft(repository, draftDirectory, temporaryDirectory, entryName, maxBytes, fail) {
+    const draftFile = path.join(draftDirectory, entryName);
+    const info = await lstat(draftFile);
+    if (typeof info.nlink === "number" && info.nlink > 1)
+        fail("draft_hardlink_not_allowed", entryName);
+    assertByteLimit(entryName, info.size, maxBytes, fail);
+    const bytes = await readFile(draftFile);
+    assertByteLimit(entryName, bytes.length, maxBytes, fail);
+    const content = bytes.toString("utf8");
+    if (!Buffer.from(content, "utf8").equals(bytes))
+        fail("handoff_utf8_invalid", entryName);
+    const stagedFile = path.join(temporaryDirectory, entryName);
+    await writeFile(stagedFile, bytes, { flag: "wx" });
+    const stagedPath = repoRelative(repository, stagedFile);
+    const parsed = parseDesignResourceHandoffMarkdown(stagedPath, content);
+    if (!("representation" in parsed.handoff))
+        fail("manifest_backed_representation_required", entryName);
+    if (parsed.handoff.targets.length !== 1)
+        fail("one_target_per_handoff_required", `${entryName}:${parsed.handoff.targets.length}`);
+    const target = parsed.handoff.targets[0];
+    const manifestResource = parsed.handoff.resources.find((resource) => resource.key === target.source_profile.fact_manifest_resource_ref);
+    if (!manifestResource)
+        fail("target_manifest_resource_missing", target.key);
+    return {
+        bytes,
+        parsed,
+        target,
+        manifest_resource: manifestResource,
+    };
+}
+function assertByteLimit(entryName, actual, maximum, fail) {
+    if (actual > maximum)
+        fail("handoff_byte_limit_exceeded", `${entryName}:${actual}:${maximum}`);
+}

package/dist/lib/design-resource-handoff-bundle.js

@@ -1,10 +1,10 @@
-import { lstat, mkdtemp, readFile, readdir, realpath, rename, rm, writeFile, } from "node:fs/promises";
+import { lstat, mkdtemp, readdir, realpath, rename, rm, } from "node:fs/promises";
 import path from "node:path";
-import { parseDesignResourceHandoffMarkdown } from "./design-resource-handoff-parser.js";
+import { stageDesignResourceHandoffDraft } from "./design-resource-handoff-bundle-draft.js";
 import { createDesignResourceHandoffSetIntegrity } from "./design-resource-handoff-set-integrity.js";
 import { preflightParsedDesignResourceHandoff } from "./design-resource-handoff-validation.js";
 import { normalizeRepositoryCwd, normalizeRepositoryFile, } from "./long-task-paths.js";
-import { repoRelative, resolveInsideRepository, } from "./long-task-workspace.js";
+import { resolveInsideRepository } from "./long-task-workspace.js";
 import { sha256Hex } from "./strict-codec.js";
 export async function publishDesignResourceHandoffBundle(options) {
     const repository = path.resolve(options.repository);
@@ -39,31 +39,7 @@ export async function publishDesignResourceHandoffBundle(options) {
         const manifests = new Map();
         const handoffSetIntegrity = createDesignResourceHandoffSetIntegrity((code, detail) => invalid(code, detail));
         for (const entry of draftEntries) {
-            const draftFile = path.join(draftAbsolute, entry.name);
-            const info = await lstat(draftFile);
-            if (typeof info.nlink === "number" && info.nlink > 1)
-                invalid("draft_hardlink_not_allowed", entry.name);
-            if (info.size > options.max_handoff_bytes)
-                invalid("handoff_byte_limit_exceeded", `${entry.name}:${info.size}:${options.max_handoff_bytes}`);
-            const bytes = await readFile(draftFile);
-            if (bytes.length > options.max_handoff_bytes)
-                invalid("handoff_byte_limit_exceeded", `${entry.name}:${bytes.length}:${options.max_handoff_bytes}`);
-            const content = bytes.toString("utf8");
-            if (!Buffer.from(content, "utf8").equals(bytes))
-                invalid("handoff_utf8_invalid", entry.name);
-            const stagedFile = path.join(temporary, entry.name);
-            await writeFile(stagedFile, bytes, { flag: "wx" });
-            const stagedPath = repoRelative(repository, stagedFile);
-            const parsed = parseDesignResourceHandoffMarkdown(stagedPath, content);
-            if (!("representation" in parsed.handoff))
-                invalid("manifest_backed_representation_required", entry.name);
-            if (parsed.handoff.targets.length !== 1)
-                invalid("one_target_per_handoff_required", `${entry.name}:${parsed.handoff.targets.length}`);
-            const declaredTarget = parsed.handoff.targets[0];
-            const manifestResource = parsed.handoff.resources.find((resource) => resource.key ===
-                declaredTarget.source_profile.fact_manifest_resource_ref);
-            if (!manifestResource)
-                invalid("target_manifest_resource_missing", declaredTarget.key);
+            const { bytes, parsed, target: declaredTarget, manifest_resource: manifestResource, } = await stageDesignResourceHandoffDraft(repository, draftAbsolute, temporary, entry.name, options.max_handoff_bytes, invalid);
             if (!declaredManifestPaths.has(manifestResource.path))
                 invalid("target_manifest_not_declared", `${declaredTarget.key}:${manifestResource.path}`);
             const preflight = await preflightParsedDesignResourceHandoff(repository, parsed);

package/dist/lib/design-resource-handoff-input-types.d.ts

@@ -0,0 +1,11 @@
+import type { DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+export type DesignResourceHandoffManifestBackedV1 = Pick<DesignResourceHandoffV1, "schema_version" | "intent" | "scope" | "provenance" | "resources" | "targets" | "resource_fact_closure" | "coverage" | "proposal"> & {
+    representation: "manifest_backed";
+};
+export type DesignResourceHandoffInputV1 = DesignResourceHandoffV1 | DesignResourceHandoffManifestBackedV1;
+export interface ParsedDesignResourceHandoffInputV1 {
+    handoff_path: string;
+    handoff: DesignResourceHandoffInputV1;
+    source_item_keys: string[];
+    source_item_kinds: Record<string, string>;
+}

package/dist/lib/design-resource-handoff-input-types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/design-resource-handoff-manifest-projection.d.ts

@@ -1,3 +1,4 @@
 import type { DesignResourceObservableFactManifestV1 } from "./design-resource-fact-manifest-types.js";
-import type { DesignResourceHandoffManifestBackedV1, DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+import type { DesignResourceHandoffManifestBackedV1 } from "./design-resource-handoff-input-types.js";
+import type { DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
 export declare function hydrateManifestBackedDesignResourceHandoff(descriptor: DesignResourceHandoffManifestBackedV1, manifests: Map<string, DesignResourceObservableFactManifestV1>): DesignResourceHandoffV1;

package/dist/lib/design-resource-handoff-parser.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-types.js";
+import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
 export interface DesignResourceHandoffBlockSpan {
     bodyStartOffset: number;
     bodyEndOffset: number;

package/dist/lib/design-resource-handoff-shape.d.ts

@@ -1,3 +1,4 @@
-import type { DesignResourceHandoffInputV1, DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+import type { DesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
+import type { DesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
 export declare function parseDesignResourceHandoffInputShape(value: unknown): DesignResourceHandoffInputV1;
 export declare function parseDesignResourceHandoffShape(value: unknown): DesignResourceHandoffV1;

package/dist/lib/design-resource-handoff-snapshot.d.ts

@@ -1,4 +1,4 @@
-import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-types.js";
+import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
 export interface DesignResourceSnapshot {
     contents: Map<string, Buffer>;
     hashes: Record<string, string>;

package/dist/lib/design-resource-handoff-types.d.ts

@@ -57,10 +57,6 @@ export interface DesignResourceHandoffV1 {
         revision: string;
     };
 }
-export type DesignResourceHandoffManifestBackedV1 = Pick<DesignResourceHandoffV1, "schema_version" | "intent" | "scope" | "provenance" | "resources" | "targets" | "resource_fact_closure" | "coverage" | "proposal"> & {
-    representation: "manifest_backed";
-};
-export type DesignResourceHandoffInputV1 = DesignResourceHandoffV1 | DesignResourceHandoffManifestBackedV1;
 export interface DesignResourceHandoffResourceV1 {
     key: string;
     role: "exact_target" | "constraint" | "supporting";
@@ -220,12 +216,6 @@ export interface ParsedDesignResourceHandoffV1 {
     source_item_keys: string[];
     source_item_kinds: Record<string, string>;
 }
-export interface ParsedDesignResourceHandoffInputV1 {
-    handoff_path: string;
-    handoff: DesignResourceHandoffInputV1;
-    source_item_keys: string[];
-    source_item_kinds: Record<string, string>;
-}
 export interface DesignResourceHandoffPreflightV1 extends ParsedDesignResourceHandoffV1 {
     schema_version: "design-resource-handoff-preflight-v1";
     status: "ready";

package/dist/lib/design-resource-handoff-validation.d.ts

@@ -1,4 +1,5 @@
-import type { DesignResourceHandoffPreflightV1, ParsedDesignResourceHandoffInputV1, ParsedDesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
+import type { ParsedDesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
+import type { DesignResourceHandoffPreflightV1, ParsedDesignResourceHandoffV1 } from "./design-resource-handoff-types.js";
 export declare function preflightDesignResourceHandoff(repository: string, handoffPath: string): Promise<DesignResourceHandoffPreflightV1>;
 export declare function preflightParsedDesignResourceHandoff(repository: string, parsed: ParsedDesignResourceHandoffInputV1): Promise<DesignResourceHandoffPreflightV1>;
 export declare function validateDesignResourceHandoffSemantics(parsed: ParsedDesignResourceHandoffV1): void;

package/dist/lib/long-task-source-item-parser.d.ts

@@ -1,5 +1,5 @@
 import type { CompiledSourceItemV2 } from "./long-task-delivery-types.js";
-import type { DesignResourceHandoffInputV1 } from "./design-resource-handoff-types.js";
+import type { DesignResourceHandoffInputV1 } from "./design-resource-handoff-input-types.js";
 import type { SemanticFactManifestV1 } from "./semantic-fact-types.js";
 export interface ParsedSourceDocument {
     items: CompiledSourceItemV2[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-tiny-context-harness",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "description": "Minimal project memory and validation harness for AI coding agents.",
   "license": "MIT",
   "author": "Seven128",