project-tiny-context-harness 0.7.9 → 0.8.0

package/dist/lib/long-task-workspace.js

@@ -15,10 +15,10 @@ export async function gitCommonDir(root) {
 }
 export async function captureWorkspaceFingerprint(rootInput, excludedPrefixes = []) {
     const root = path.resolve(rootInput);
-    const [head, headTree, indexTree, staged, unstaged, statusBytes, untracked] = await Promise.all([
+    const indexTree = await gitOutput(root, ["write-tree"]);
+    const [head, headTree, staged, unstaged, statusBytes, untracked] = await Promise.all([
         gitOutput(root, ["rev-parse", "HEAD"]),
         gitOutput(root, ["rev-parse", "HEAD^{tree}"]),
-        gitOutput(root, ["write-tree"]),
         gitBuffer(root, scopedDiffArgs(["diff", "--cached", "--binary", "--no-ext-diff"], excludedPrefixes)),
         gitBuffer(root, scopedDiffArgs(["diff", "--binary", "--no-ext-diff"], excludedPrefixes)),
         Promise.all([
@@ -51,11 +51,11 @@ export async function captureWorkspaceManifest(rootInput, workdirInput, _copyRoo
         workdir,
         ...additionalExcludedWorkdirs,
     ]);
-    const [indexBytes, modifiedBytes, untrackedBytes, fingerprint] = await Promise.all([
+    const fingerprint = await captureWorkspaceFingerprint(root, excluded);
+    const [indexBytes, modifiedBytes, untrackedBytes] = await Promise.all([
         gitBuffer(root, ["ls-files", "--stage", "-z"]),
         gitBuffer(root, ["diff", "--name-only", "-z"]),
         gitBuffer(root, ["ls-files", "--others", "--exclude-standard", "-z"]),
-        captureWorkspaceFingerprint(root, excluded),
     ]);
     const files = new Map();
     for (const record of splitZero(indexBytes)) {
@@ -114,7 +114,11 @@ export async function createWorkspaceSnapshot(rootInput, workdirInput, label, ad
     const started = performance.now();
     const root = path.resolve(rootInput);
     const workdir = path.resolve(workdirInput);
-    const excluded = excludedPrefixes(root, [
+    const fingerprintExcluded = excludedPrefixes(root, [
+        workdir,
+        ...additionalExcludedWorkdirs,
+    ]);
+    const snapshotExcluded = snapshotExcludedPrefixes(root, [
         workdir,
         ...additionalExcludedWorkdirs,
     ]);
@@ -128,6 +132,7 @@ export async function createWorkspaceSnapshot(rootInput, workdirInput, label, ad
             "--force",
             `--prefix=${temporary.replace(/\\/gu, "/")}/`,
         ]);
+        await overlayTrackedEolDifferences(root, temporary);
         const [modified, untracked] = await Promise.all([
             gitBuffer(root, ["diff", "--name-only", "-z"]),
             gitBuffer(root, ["ls-files", "--others", "--exclude-standard", "-z"]),
@@ -137,7 +142,7 @@ export async function createWorkspaceSnapshot(rootInput, workdirInput, label, ad
             ...splitZero(untracked),
         ])) {
             const relative = raw.replace(/\\/gu, "/");
-            if (excludedPath(relative, excluded))
+            if (excludedPath(relative, snapshotExcluded))
                 continue;
             const source = path.join(root, ...relative.split("/"));
             const target = path.join(temporary, ...relative.split("/"));
@@ -149,12 +154,12 @@ export async function createWorkspaceSnapshot(rootInput, workdirInput, label, ad
             await mkdir(path.dirname(target), { recursive: true });
             await copyFile(source, target);
         }
-        await removeExcludedSnapshotPaths(temporary, excluded);
+        await removeExcludedSnapshotPaths(temporary, snapshotExcluded);
         await linkDependencyTrees(root, temporary, [
             workdir,
             ...additionalExcludedWorkdirs,
         ]);
-        const after = await captureWorkspaceFingerprint(root, excluded);
+        const after = await captureWorkspaceFingerprint(root, fingerprintExcluded);
         if (after.identity !== before.identity)
             throw new Error("workspace_changed_during_snapshot");
         return {
@@ -176,6 +181,23 @@ export function changedWorkspacePaths(baseline, current) {
         .filter((file) => before.get(file) !== after.get(file))
         .sort();
 }
+export async function changedWorkspacePathsFromHead(rootInput, workdirInput, additionalExcludedWorkdirs = []) {
+    const root = path.resolve(rootInput);
+    const workdir = path.resolve(workdirInput);
+    const excluded = excludedPrefixes(root, [
+        workdir,
+        ...additionalExcludedWorkdirs,
+    ]);
+    const [trackedBytes, untrackedBytes] = await Promise.all([
+        gitBuffer(root, scopedDiffArgs(["diff", "--name-only", "--no-renames", "--no-ext-diff", "-z", "HEAD"], excluded)),
+        gitBuffer(root, ["ls-files", "--others", "--exclude-standard", "-z"]),
+    ]);
+    return [
+        ...new Set([...splitZero(trackedBytes), ...splitZero(untrackedBytes)]
+            .map((raw) => raw.replace(/\\/gu, "/"))
+            .filter((relative) => !excludedPath(relative, excluded))),
+    ].sort();
+}
 export async function currentGitState(root) {
     const [head, tree, raw] = await Promise.all([
         gitOutput(root, ["rev-parse", "HEAD"]),
@@ -255,8 +277,13 @@ async function untrackedIdentity(root, excluded) {
 }
 function excludedPrefixes(root, workdirs) {
     return [
-        ...workdirs.map((workdir) => repoRelative(root, path.resolve(workdir))),
+        ...snapshotExcludedPrefixes(root, workdirs),
         "project_context",
+    ].filter(Boolean);
+}
+function snapshotExcludedPrefixes(root, workdirs) {
+    return [
+        ...workdirs.map((workdir) => repoRelative(root, path.resolve(workdir))),
         "tmp/ty-context/long-task-runs",
     ].filter(Boolean);
 }
@@ -283,6 +310,43 @@ async function removeExcludedSnapshotPaths(snapshotRoot, excluded) {
     }
     await visit(snapshotRoot);
 }
+async function overlayTrackedEolDifferences(sourceRoot, snapshotRoot) {
+    const [raw, autocrlf] = await Promise.all([
+        gitBuffer(sourceRoot, ["ls-files", "--eol", "-z"]),
+        gitConfigGet(sourceRoot, "core.autocrlf"),
+    ]);
+    for (const record of splitZero(raw)) {
+        const tab = record.indexOf("\t");
+        if (tab < 0)
+            continue;
+        const metadata = record.slice(0, tab);
+        const relative = record.slice(tab + 1).replace(/\\/gu, "/");
+        const match = metadata.match(/^i\/(\S+)\s+w\/(\S+)\s+attr\/(.*)$/u);
+        if (!match)
+            continue;
+        const [, indexEol, worktreeEol, attributesRaw] = match;
+        const expected = checkoutEol(indexEol, attributesRaw.trim(), autocrlf);
+        if (worktreeEol === expected)
+            continue;
+        const source = path.join(sourceRoot, ...relative.split("/"));
+        const target = path.join(snapshotRoot, ...relative.split("/"));
+        const info = await stat(source).catch(() => null);
+        if (!info?.isFile())
+            continue;
+        await mkdir(path.dirname(target), { recursive: true });
+        await copyFile(source, target);
+    }
+}
+function checkoutEol(indexEol, attributes, autocrlf) {
+    const explicit = attributes.match(/(?:^|\s)eol=(lf|crlf)(?:\s|$)/u)?.[1];
+    if (explicit)
+        return explicit;
+    if (/(?:^|\s)-text(?:\s|$)/u.test(attributes))
+        return indexEol;
+    if (indexEol === "-text" || indexEol === "none")
+        return indexEol;
+    return autocrlf?.toLowerCase() === "true" ? "crlf" : indexEol;
+}
 async function linkDependencyTrees(sourceRoot, snapshotRoot, workdirs) {
     const protectedWorkdirs = workdirs.map((workdir) => repoRelative(sourceRoot, workdir));
     async function visit(directory, relative = "") {

package/dist/schemas/long-task-delivery-v2/long-task-delivery-v2.schema.json

@@ -183,8 +183,15 @@
                 "requirements": { "type": "array", "items": { "$ref": "#/$defs/requirement" }, "default": [] },
                 "owner_surfaces": { "$ref": "#/$defs/nonEmptyStrings", "default": [] },
                 "controls": { "type": "array", "items": { "$ref": "#/$defs/control" }, "default": [] },
+                "surface_bindings": { "type": "array", "items": { "$ref": "#/$defs/surfaceBinding" }, "default": [] },
                 "non_completing_outcomes": { "type": "array", "items": { "$ref": "#/$defs/keyedStatement" }, "default": [] }
-            }
+            },
+            "allOf": [
+                {
+                    "if": { "required": ["controls"], "properties": { "controls": { "minItems": 1 } } },
+                    "then": { "required": ["surface_bindings"], "properties": { "surface_bindings": { "minItems": 1 } } }
+                }
+            ]
         },
         "requirement": {
             "type": "object",
@@ -198,6 +205,81 @@
             "required": ["key", "location"],
             "properties": { "key": { "$ref": "#/$defs/key" }, "surface": { "type": "string", "default": "" }, "region": { "type": "string", "default": "" }, "location": { "$ref": "#/$defs/nonEmpty" }, "control_type": { "type": "string", "default": "" }, "label_content": { "type": "string", "default": "" }, "user_task": { "type": "string", "default": "" }, "visibility": { "type": "string", "default": "" }, "availability": { "type": "string", "default": "" }, "trigger": { "type": "string", "default": "" }, "input": { "type": "string", "default": "" }, "validation": { "type": "string", "default": "" }, "default_value": { "type": "string", "default": "" }, "interaction": { "type": "string", "default": "" }, "navigation_result": { "type": "string", "default": "" }, "loading_state": { "type": "string", "default": "" }, "empty_state": { "type": "string", "default": "" }, "success_state": { "type": "string", "default": "" }, "failure_state": { "type": "string", "default": "" }, "recovery": { "type": "string", "default": "" }, "permission": { "type": "string", "default": "" }, "feedback": { "type": "string", "default": "" }, "accessibility": { "type": "string", "default": "" } }
         },
+        "surfaceBinding": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["key", "surface_ref", "target_ref", "control_refs", "route_binding_ref", "component_binding_refs", "root_journey_check_ref", "entry_action_ref", "design_targets", "acceptance_blockers"],
+            "properties": {
+                "key": { "$ref": "#/$defs/key" },
+                "surface_ref": { "$ref": "#/$defs/nonEmpty" },
+                "target_ref": { "$ref": "#/$defs/key" },
+                "control_refs": { "$ref": "#/$defs/keys" },
+                "route_binding_ref": { "$ref": "#/$defs/key" },
+                "component_binding_refs": { "$ref": "#/$defs/keys" },
+                "root_journey_check_ref": { "$ref": "#/$defs/key" },
+                "entry_action_ref": { "$ref": "#/$defs/key" },
+                "design_targets": { "type": "array", "items": { "$ref": "#/$defs/designTarget" } },
+                "acceptance_blockers": { "type": "array", "items": { "$ref": "#/$defs/designAcceptanceBlocker" } }
+            }
+        },
+        "designTarget": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["key", "interpretation", "source_paths", "condition_keys", "claim_refs", "conformance_check_ref", "conformance_assertion_ref", "verification_method_bindings", "actual_artifact_path", "comparison_artifact_path"],
+            "properties": {
+                "key": { "$ref": "#/$defs/key" },
+                "interpretation": { "enum": ["exact_target", "constraint"] },
+                "source_paths": { "$ref": "#/$defs/nonEmptyStrings" },
+                "condition_keys": { "$ref": "#/$defs/keys" },
+                "claim_refs": { "$ref": "#/$defs/nonEmptyStrings" },
+                "conformance_check_ref": { "$ref": "#/$defs/key" },
+                "conformance_assertion_ref": { "$ref": "#/$defs/key" },
+                "verification_method_bindings": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "required": ["method", "assertion_ref"],
+                        "properties": {
+                            "method": { "$ref": "#/$defs/designVerificationMethod" },
+                            "assertion_ref": { "$ref": "#/$defs/key" }
+                        }
+                    }
+                },
+                "actual_artifact_path": { "$ref": "#/$defs/nonEmpty" },
+                "comparison_artifact_path": { "$ref": "#/$defs/nonEmpty" }
+            }
+        },
+        "designAcceptanceBlocker": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["key", "status", "refs", "source_item_refs", "verification_methods", "rationale"],
+            "properties": {
+                "key": { "$ref": "#/$defs/key" },
+                "status": { "enum": ["machine_claim", "external_confirmation"] },
+                "refs": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/nonEmpty" } },
+                "source_item_refs": { "$ref": "#/$defs/nonEmptyStrings" },
+                "verification_methods": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/designVerificationMethod" } },
+                "rationale": { "$ref": "#/$defs/nonEmpty" }
+            }
+        },
+        "designVerificationMethod": {
+            "enum": [
+                "layout_geometry",
+                "visual_pixel",
+                "design_token",
+                "content",
+                "component_state",
+                "interaction_trace",
+                "motion_timeline",
+                "responsive_reflow",
+                "input_method",
+                "accessibility_semantics",
+                "asset_integrity"
+            ]
+        },
         "technical": {
             "type": "object",
             "additionalProperties": false,
@@ -321,7 +403,7 @@
                 "when": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/keyedStatement" } }
             }
         },
-        "evidenceCapability": { "enum": ["presence", "interaction_trace", "state_delta", "cross_surface_consistency", "durable_readback", "boundary_invocation", "external_side_effect", "failure_injection", "visual_render", "target_runtime", "input_variation"] },
+        "evidenceCapability": { "enum": ["presence", "interaction_trace", "state_delta", "cross_surface_consistency", "durable_readback", "boundary_invocation", "external_side_effect", "failure_injection", "visual_render", "design_conformance", "target_runtime", "input_variation"] },
         "environment": {
             "oneOf": [
                 {

package/migrations/README.md

@@ -1,10 +1,10 @@
-# Migrations
-
-Schema migrations for Harness config and managed file layout belong here.
-
-Version 0.6.0 includes `long-task-v1-retirement`. It safely removes the
-retired repo-local Hook, reports a legacy active projection as
-`manual_required`, and deliberately does not import V1 progress or receipts
+# Migrations
+
+Schema migrations for Harness config and managed file layout belong here.
+
+Version 0.6.0 includes `long-task-v1-retirement`. It safely removes the
+retired repo-local Hook, reports a legacy active projection as
+`manual_required`, and deliberately does not import V1 progress or receipts
 into the V2 Claim/Evidence authority.
 
 Version 0.7.2 includes `long-task-v2-semantic-drift-authority`. It reports a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-tiny-context-harness",
-  "version": "0.7.9",
+  "version": "0.8.0",
   "description": "Minimal project memory and validation harness for AI coding agents.",
   "license": "MIT",
   "author": "Seven128",
@@ -48,7 +48,7 @@
     "source-mappings.yaml"
   ],
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "build": "node ../../tools/package_build_fingerprint.mjs build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test:default:built": "node ../../tests/ty-context/run-package-suite.mjs default",
     "test:default": "npm run build && npm run test:default:built",
@@ -58,7 +58,7 @@
     "pretest": "npm run build",
     "test": "npm run test:built",
     "test:workflow-default:built": "node --test --test-concurrency=1 ../../tests/ty-context/workflow-contract-routing.test.mjs",
-    "test:delivery-contract:built": "node --test --test-concurrency=1 ../../tests/ty-context/long-task-compact-authoring.test.mjs ../../tests/ty-context/long-task-authoring-claims.test.mjs ../../tests/ty-context/long-task-authoring-preflight.test.mjs ../../tests/ty-context/long-task-authority-authoring-fields.test.mjs ../../tests/ty-context/long-task-playwright-ac-evidence.test.mjs ../../tests/ty-context/long-task-delivery-parser.test.mjs ../../tests/ty-context/long-task-delivery-compiler.test.mjs ../../tests/ty-context/long-task-delivery-risk.test.mjs ../../tests/ty-context/long-task-claim-coverage.test.mjs ../../tests/ty-context/long-task-closure-invariants.test.mjs ../../tests/ty-context/long-task-source-authority-closure.test.mjs ../../tests/ty-context/long-task-evidence-sensitivity-policy.test.mjs ../../tests/ty-context/long-task-global-evidence-sensitivity.test.mjs ../../tests/ty-context/long-task-source-risk-binding.test.mjs ../../tests/ty-context/long-task-non-completing-source.test.mjs ../../tests/ty-context/long-task-playwright-trust-boundary.test.mjs ../../tests/ty-context/long-task-planned-counterfactual.test.mjs ../../tests/ty-context/long-task-public-contract-example.test.mjs ../../tests/ty-context/long-task-release-tarball-contract.test.mjs ../../tests/ty-context/long-task-semantic-drift-closure.test.mjs ../../tests/ty-context/long-task-semantic-drift-lifecycle.test.mjs",
+    "test:delivery-contract:built": "node --test --test-concurrency=1 ../../tests/ty-context/long-task-compact-authoring.test.mjs ../../tests/ty-context/long-task-authoring-claims.test.mjs ../../tests/ty-context/long-task-authoring-preflight.test.mjs ../../tests/ty-context/long-task-authority-authoring-fields.test.mjs ../../tests/ty-context/long-task-playwright-ac-evidence.test.mjs ../../tests/ty-context/long-task-delivery-parser.test.mjs ../../tests/ty-context/long-task-delivery-compiler.test.mjs ../../tests/ty-context/long-task-delivery-risk.test.mjs ../../tests/ty-context/long-task-claim-coverage.test.mjs ../../tests/ty-context/long-task-closure-invariants.test.mjs ../../tests/ty-context/long-task-source-authority-closure.test.mjs ../../tests/ty-context/long-task-evidence-sensitivity-policy.test.mjs ../../tests/ty-context/long-task-global-evidence-sensitivity.test.mjs ../../tests/ty-context/long-task-source-risk-binding.test.mjs ../../tests/ty-context/long-task-non-completing-source.test.mjs ../../tests/ty-context/long-task-playwright-trust-boundary.test.mjs ../../tests/ty-context/long-task-planned-counterfactual.test.mjs ../../tests/ty-context/long-task-public-contract-example.test.mjs ../../tests/ty-context/long-task-release-tarball-contract.test.mjs ../../tests/ty-context/long-task-semantic-drift-closure.test.mjs ../../tests/ty-context/long-task-semantic-drift-lifecycle.test.mjs ../../tests/ty-context/long-task-workspace-scope.test.mjs",
     "test:delivery-contract": "npm run build && npm run test:delivery-contract:built",
     "test:long-task-workflow:built": "node ../../tests/ty-context/run-package-suite.mjs long-task",
     "test:long-task-workflow": "npm run build && npm run test:long-task-workflow:built",

package/source-mappings.yaml

@@ -1,25 +1,25 @@
-source_mappings:
-  - source: ".codex/ty-context-managed/agents/AGENTS_CORE.md"
-    target: "packages/ty-context/assets/agents/AGENTS_CORE.md"
-    mode: "copy-file"
-  - source: "README.md"
-    target: "packages/ty-context/assets/README.md"
-    mode: "copy-file"
-  - source: "README.zh-CN.md"
-    target: "packages/ty-context/assets/README.zh-CN.md"
-    mode: "copy-file"
-  - source: ".codex/ty-context-managed/context_templates"
-    target: "packages/ty-context/assets/context_templates"
-    mode: "copy-tree"
-  - source: ".codex/ty-context-managed/skills"
-    target: "packages/ty-context/assets/skills"
-    mode: "copy-tree"
-  - source: ".codex/ty-context-managed/make/ty-context.mk"
-    target: "packages/ty-context/assets/make/ty-context.mk"
-    mode: "copy-file"
-  - source: ".codex/ty-context-managed/minimal_tools"
-    target: "packages/ty-context/assets/tools"
-    mode: "copy-tree"
-  - source: ".github/workflows/harness.yml"
-    target: "packages/ty-context/assets/github/harness.yml"
-    mode: "copy-file"
+source_mappings:
+  - source: ".codex/ty-context-managed/agents/AGENTS_CORE.md"
+    target: "packages/ty-context/assets/agents/AGENTS_CORE.md"
+    mode: "copy-file"
+  - source: "README.md"
+    target: "packages/ty-context/assets/README.md"
+    mode: "copy-file"
+  - source: "README.zh-CN.md"
+    target: "packages/ty-context/assets/README.zh-CN.md"
+    mode: "copy-file"
+  - source: ".codex/ty-context-managed/context_templates"
+    target: "packages/ty-context/assets/context_templates"
+    mode: "copy-tree"
+  - source: ".codex/ty-context-managed/skills"
+    target: "packages/ty-context/assets/skills"
+    mode: "copy-tree"
+  - source: ".codex/ty-context-managed/make/ty-context.mk"
+    target: "packages/ty-context/assets/make/ty-context.mk"
+    mode: "copy-file"
+  - source: ".codex/ty-context-managed/minimal_tools"
+    target: "packages/ty-context/assets/tools"
+    mode: "copy-tree"
+  - source: ".github/workflows/harness.yml"
+    target: "packages/ty-context/assets/github/harness.yml"
+    mode: "copy-file"