project-tiny-context-harness 0.2.84 → 0.6.0

package/dist/lib/managed-file.js

@@ -18,15 +18,30 @@ export const MANAGED_METADATA_START = "<!-- ty-context-managed";
 export const MANAGED_METADATA_END = "-->";
 export const AGENTS_BLOCK_MARKERS = [
     { start: MANAGED_BLOCK_START, end: MANAGED_BLOCK_END },
-    { start: LEGACY_PJSDLC_MANAGED_BLOCK_START, end: LEGACY_PJSDLC_MANAGED_BLOCK_END },
-    { start: LEGACY_SDLC_MANAGED_BLOCK_START, end: LEGACY_SDLC_MANAGED_BLOCK_END }
+    {
+        start: LEGACY_PJSDLC_MANAGED_BLOCK_START,
+        end: LEGACY_PJSDLC_MANAGED_BLOCK_END,
+    },
+    {
+        start: LEGACY_SDLC_MANAGED_BLOCK_START,
+        end: LEGACY_SDLC_MANAGED_BLOCK_END,
+    },
 ];
 export const MAKEFILE_BLOCK_MARKERS = [
     { start: MAKEFILE_BLOCK_START, end: MAKEFILE_BLOCK_END },
-    { start: LEGACY_PJSDLC_MAKEFILE_BLOCK_START, end: LEGACY_PJSDLC_MAKEFILE_BLOCK_END },
-    { start: LEGACY_SDLC_MAKEFILE_BLOCK_START, end: LEGACY_SDLC_MAKEFILE_BLOCK_END }
+    {
+        start: LEGACY_PJSDLC_MAKEFILE_BLOCK_START,
+        end: LEGACY_PJSDLC_MAKEFILE_BLOCK_END,
+    },
+    {
+        start: LEGACY_SDLC_MAKEFILE_BLOCK_START,
+        end: LEGACY_SDLC_MAKEFILE_BLOCK_END,
+    },
 ];
 export const GITHUB_WORKFLOW_BLOCK_MARKERS = [
     { start: GITHUB_WORKFLOW_BLOCK_START, end: GITHUB_WORKFLOW_BLOCK_END },
-    { start: LEGACY_PJSDLC_GITHUB_WORKFLOW_BLOCK_START, end: LEGACY_PJSDLC_GITHUB_WORKFLOW_BLOCK_END }
+    {
+        start: LEGACY_PJSDLC_GITHUB_WORKFLOW_BLOCK_START,
+        end: LEGACY_PJSDLC_GITHUB_WORKFLOW_BLOCK_END,
+    },
 ];

package/dist/lib/migrations.js

@@ -1,19 +1,41 @@
 import path from "node:path";
 import { promises as fs } from "node:fs";
-import { CONTEXT_MANIFEST_PATH, contextManifestFromExistingAreas } from "./context-manifest.js";
-import { architectureContextTemplate, areaContextTemplate, globalContextTemplate, verificationContextTemplate } from "./context-templates.js";
+import { CONTEXT_MANIFEST_PATH, contextManifestFromExistingAreas, } from "./context-manifest.js";
+import { architectureContextTemplate, areaContextTemplate, globalContextTemplate, verificationContextTemplate, } from "./context-templates.js";
 import { CURRENT_SCHEMA_VERSION } from "./constants.js";
 import { defaultConfig, readConfig } from "./config.js";
 import { createDesignMdIfMissing, DESIGN_MD_PATH } from "./design-md.js";
-import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged } from "./fs.js";
+import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged, } from "./fs.js";
 import { harnessConfigPath, harnessRoot } from "./harness-root.js";
 import { legacySdlcHarnessMigration } from "./legacy-sdlc-migration.js";
-import { stringifyYaml } from "./yaml.js";
+import { parseYaml, stringifyYaml } from "./yaml.js";
 async function verifyNoop() {
     return;
 }
 export const migrations = [
     legacySdlcHarnessMigration,
+    {
+        id: "long-task-v1-retirement",
+        introducedIn: "0.6.0",
+        description: "Retire the V1 acceptance runtime and repo-local Hook before enabling the sole V2 authority path.",
+        scope: "<harnessRoot>/hooks/long-task-hook.mjs and legacy active-long-task projection",
+        risk: "safe",
+        manualMessage: "An unfinished V1 Contract cannot be silently upgraded because Claim Coverage, owner boundaries, verification inputs and Counterfactual V2 require explicit product authority.",
+        detect: detectLongTaskV1Retirement,
+        apply: migrateLongTaskV1Retirement,
+        verify: verifyLongTaskV1Retirement,
+    },
+    {
+        id: "composite-codex-to-long-task",
+        introducedIn: "0.5.0",
+        description: "Replace the retired composite-codex profile with the Single-Goal long-task profile without importing historical Campaign state.",
+        scope: "<harnessRoot>/config.yaml and package-owned retired Long-Task assets",
+        risk: "safe",
+        manualMessage: "Historical Campaign/source/Contract files remain ordinary user files and are intentionally not imported or executed.",
+        detect: detectCompositeCodexProfile,
+        apply: migrateCompositeCodexProfile,
+        verify: verifyCompositeCodexProfile,
+    },
     {
         id: "schema-v4-config-refresh",
         introducedIn: "0.2.0",
@@ -23,7 +45,7 @@ export const migrations = [
         manualMessage: "Review Harness config manually if custom managed-file paths still drift after upgrade.",
         detect: detectConfigRefresh,
         apply: migrateConfig,
-        verify: verifyNoop
+        verify: verifyNoop,
     },
     {
         id: "legacy-modules-to-areas",
@@ -34,7 +56,7 @@ export const migrations = [
         manualMessage: "Resolve target conflicts manually; the Harness will not overwrite existing area Context files.",
         detect: detectLegacyModulesToAreas,
         apply: migrateLegacyModulesToAreas,
-        verify: verifyNoop
+        verify: verifyNoop,
     },
     {
         id: "context-manifest-baseline",
@@ -45,7 +67,7 @@ export const migrations = [
         manualMessage: "Review deep area files without manifest roles and assign explicit context roles when needed.",
         detect: detectContextManifestBaseline,
         apply: migrateContextManifest,
-        verify: verifyNoop
+        verify: verifyNoop,
     },
     {
         id: "global-context-v4-sections",
@@ -56,7 +78,7 @@ export const migrations = [
         manualMessage: "Review global Context manually if project-specific long-term facts need refinement.",
         detect: detectGlobalContextSections,
         apply: migrateGlobalContextSections,
-        verify: verifyNoop
+        verify: verifyNoop,
     },
     {
         id: "design-md-baseline",
@@ -67,7 +89,7 @@ export const migrations = [
         manualMessage: "Review the starter design baseline and replace it with project-specific visual facts when available.",
         detect: detectDesignMdBaseline,
         apply: migrateDesignMd,
-        verify: verifyNoop
+        verify: verifyNoop,
     },
     {
         id: "deprecated-skill-overrides",
@@ -77,12 +99,39 @@ export const migrations = [
         risk: "manual",
         manualMessage: "Move override files into standalone project-local Skills before running sync.",
         detect: detectDeprecatedSkillOverrides,
-        verify: verifyNoop
-    }
+        verify: verifyNoop,
+    },
 ];
+async function detectLongTaskV1Retirement(projectRoot, root, migration) {
+    const items = [];
+    const hook = path.join(projectRoot, root, "hooks", "long-task-hook.mjs");
+    if (await pathExists(hook))
+        items.push(item(migration, "safe_pending", path.relative(projectRoot, hook).split(path.sep).join("/"), "The V1 repo-local Hook can be removed; V2 invokes the package-owned verifier entry directly."));
+    const projection = path.join(projectRoot, root, "ty-context-active-long-task.json");
+    if (await pathExists(projection))
+        items.push(item(migration, "manual_required", path.relative(projectRoot, projection).split(path.sep).join("/"), "Retire or explicitly rewrite the unfinished V1 task as a V2 Contract; upgrade will not import historical acceptance state."));
+    return items;
+}
+async function migrateLongTaskV1Retirement(projectRoot, root, report) {
+    const hook = path.join(projectRoot, root, "hooks", "long-task-hook.mjs");
+    if (await pathExists(hook)) {
+        await fs.rm(hook, { force: true });
+        report.changed.push(path.relative(projectRoot, hook).split(path.sep).join("/"));
+    }
+    else
+        report.skipped.push("long-task-v1-retirement:repo-local-hook");
+}
+async function verifyLongTaskV1Retirement(projectRoot, root) {
+    if (await pathExists(path.join(projectRoot, root, "hooks", "long-task-hook.mjs")))
+        throw new Error("long-task-v1-retirement migration verification failed");
+}
 export async function createUpgradePlan(projectRoot) {
     const root = await harnessRoot(projectRoot);
-    const plan = { safe_pending: [], manual_required: [], blocked: [] };
+    const plan = {
+        safe_pending: [],
+        manual_required: [],
+        blocked: [],
+    };
     for (const migration of migrations) {
         for (const item of await migration.detect(projectRoot, root, migration.id)) {
             plan[item.status].push(item);
@@ -91,7 +140,9 @@ export async function createUpgradePlan(projectRoot) {
     return plan;
 }
 export function hasUpgradePlanWork(plan) {
-    return plan.safe_pending.length > 0 || plan.manual_required.length > 0 || plan.blocked.length > 0;
+    return (plan.safe_pending.length > 0 ||
+        plan.manual_required.length > 0 ||
+        plan.blocked.length > 0);
 }
 export function updateModeForPlan(plan) {
     if (plan.manual_required.length > 0 || plan.blocked.length > 0) {
@@ -104,9 +155,13 @@ export function updateModeForPlan(plan) {
 }
 export function formatUpgradePlan(plan) {
     const lines = [
-        `upgrade plan mode=${updateModeForPlan(plan)} safe_pending=${plan.safe_pending.length} manual_required=${plan.manual_required.length} blocked=${plan.blocked.length}`
+        `upgrade plan mode=${updateModeForPlan(plan)} safe_pending=${plan.safe_pending.length} manual_required=${plan.manual_required.length} blocked=${plan.blocked.length}`,
     ];
-    for (const status of ["safe_pending", "manual_required", "blocked"]) {
+    for (const status of [
+        "safe_pending",
+        "manual_required",
+        "blocked",
+    ]) {
         for (const item of plan[status]) {
             const location = item.path ? ` ${item.path}` : "";
             lines.push(`${status}: ${item.id}${location} - ${item.message}`);
@@ -115,7 +170,12 @@ export function formatUpgradePlan(plan) {
     return lines;
 }
 export async function runMigrations(projectRoot, existingPlan) {
-    const report = { changed: [], skipped: [], manualRequired: [], blocked: [] };
+    const report = {
+        changed: [],
+        skipped: [],
+        manualRequired: [],
+        blocked: [],
+    };
     const root = await harnessRoot(projectRoot);
     const plan = existingPlan ?? (await createUpgradePlan(projectRoot));
     report.manualRequired.push(...plan.manual_required);
@@ -142,13 +202,16 @@ async function migrateBaseProjectContext(projectRoot, report) {
     await ensureDir(path.join(projectRoot, "project_context", "areas"));
     const files = [
         ["project_context/global.md", globalContextTemplate()],
-        ["project_context/architecture.md", architectureContextTemplate()]
+        ["project_context/architecture.md", architectureContextTemplate()],
     ];
     if (await contextManifestReferences(projectRoot, "project_context/areas/main.md")) {
         files.push(["project_context/areas/main.md", areaContextTemplate("main")]);
     }
     if (await contextManifestReferences(projectRoot, "project_context/areas/main/verification.md")) {
-        files.push(["project_context/areas/main/verification.md", verificationContextTemplate("main")]);
+        files.push([
+            "project_context/areas/main/verification.md",
+            verificationContextTemplate("main"),
+        ]);
     }
     for (const [relative, content] of files) {
         const target = path.join(projectRoot, ...relative.split("/"));
@@ -186,7 +249,7 @@ async function detectGlobalContextSections(projectRoot, _root, migration) {
         return [];
     }
     return [
-        item(migration, "safe_pending", relative, "Global Context needs Schema v4 sections or legacy module path rewrites.")
+        item(migration, "safe_pending", relative, "Global Context needs Schema v4 sections or legacy module path rewrites."),
     ];
 }
 async function migrateGlobalContextSections(projectRoot, _root, report) {
@@ -212,7 +275,9 @@ async function migrateGlobalContextSections(projectRoot, _root, report) {
         report.skipped.push(`${relative}#schema-v4-sections`);
         return;
     }
-    const next = additions.length === 0 ? rewritten : `${rewritten.replace(/\s*$/, "\n\n")}${additions.join("\n")}`;
+    const next = additions.length === 0
+        ? rewritten
+        : `${rewritten.replace(/\s*$/, "\n\n")}${additions.join("\n")}`;
     if (await writeTextIfChanged(target, next)) {
         report.changed.push(`${relative}#schema-v4-sections`);
     }
@@ -226,7 +291,7 @@ async function detectContextManifestBaseline(projectRoot, _root, migration) {
         return [];
     }
     const items = [
-        item(migration, "safe_pending", CONTEXT_MANIFEST_PATH, "Context graph manifest is missing and can be created from existing area files.")
+        item(migration, "safe_pending", CONTEXT_MANIFEST_PATH, "Context graph manifest is missing and can be created from existing area files."),
     ];
     for (const ambiguous of await ambiguousAreaContextFiles(projectRoot)) {
         items.push(item(migration, "manual_required", ambiguous, "Deep area Context cannot be safely role-classified by path alone; review context.toml after upgrade."));
@@ -249,7 +314,9 @@ async function migrateContextManifest(projectRoot, _root, report) {
 async function detectLegacyModulesToAreas(projectRoot, _root, migration) {
     const modulesRoot = path.join(projectRoot, "project_context", "modules");
     const areasRoot = path.join(projectRoot, "project_context", "areas");
-    const moduleFiles = (await listFiles(modulesRoot)).filter((file) => file.endsWith(".md")).sort();
+    const moduleFiles = (await listFiles(modulesRoot))
+        .filter((file) => file.endsWith(".md"))
+        .sort();
     const items = [];
     for (const source of moduleFiles) {
         const relativeToModules = path.relative(modulesRoot, source);
@@ -268,7 +335,9 @@ async function detectLegacyModulesToAreas(projectRoot, _root, migration) {
 async function migrateLegacyModulesToAreas(projectRoot, _root, report) {
     const modulesRoot = path.join(projectRoot, "project_context", "modules");
     const areasRoot = path.join(projectRoot, "project_context", "areas");
-    const moduleFiles = (await listFiles(modulesRoot)).filter((file) => file.endsWith(".md")).sort();
+    const moduleFiles = (await listFiles(modulesRoot))
+        .filter((file) => file.endsWith(".md"))
+        .sort();
     if (moduleFiles.length === 0) {
         report.skipped.push("project_context/modules");
         return;
@@ -288,7 +357,7 @@ async function migrateLegacyModulesToAreas(projectRoot, _root, report) {
         report.changed.push(`${sourceRelative} -> ${targetRelative}`);
     }
     const remainingFiles = await listFiles(modulesRoot);
-    if (remainingFiles.length === 0 && await pathExists(modulesRoot)) {
+    if (remainingFiles.length === 0 && (await pathExists(modulesRoot))) {
         await fs.rm(modulesRoot, { recursive: true, force: true });
         report.changed.push("removed project_context/modules");
     }
@@ -300,14 +369,62 @@ async function migrateManifestModulePaths(projectRoot, report) {
     }
     const original = await readText(manifestPath);
     const next = ensureManifestDefaultArea(rewriteLegacyModuleReferences(original));
-    if (next !== original && await writeTextIfChanged(manifestPath, next)) {
+    if (next !== original && (await writeTextIfChanged(manifestPath, next))) {
         report.changed.push(`${CONTEXT_MANIFEST_PATH}#areas-paths`);
     }
 }
 async function detectDesignMdBaseline(projectRoot, _root, migration) {
     return (await pathExists(path.join(projectRoot, DESIGN_MD_PATH)))
         ? []
-        : [item(migration, "safe_pending", DESIGN_MD_PATH, "DESIGN.md is missing and can be created with the package baseline.")];
+        : [
+            item(migration, "safe_pending", DESIGN_MD_PATH, "DESIGN.md is missing and can be created with the package baseline."),
+        ];
+}
+async function detectCompositeCodexProfile(projectRoot, _root, migration) {
+    const relative = await harnessConfigPath(projectRoot);
+    const file = path.join(projectRoot, relative);
+    if (!(await pathExists(file)))
+        return [];
+    const raw = parseYaml(await readText(file));
+    return raw.profiles?.enabled?.includes("composite-codex")
+        ? [
+            item(migration, "safe_pending", relative, "The retired composite-codex profile can be safely replaced with long-task; historical user files will be preserved."),
+        ]
+        : [];
+}
+async function migrateCompositeCodexProfile(projectRoot, root, report) {
+    const relative = await harnessConfigPath(projectRoot);
+    const file = path.join(projectRoot, relative);
+    const raw = parseYaml(await readText(file));
+    const profiles = raw.profiles && typeof raw.profiles === "object"
+        ? raw.profiles
+        : {};
+    const enabled = Array.isArray(profiles.enabled) ? profiles.enabled : [];
+    profiles.enabled = [
+        ...new Set(enabled.map((profile) => profile === "composite-codex" ? "long-task" : profile)),
+    ];
+    raw.profiles = profiles;
+    if (await writeTextIfChanged(file, stringifyYaml(raw)))
+        report.changed.push(relative);
+    else
+        report.skipped.push(relative);
+    for (const retired of [
+        path.join(projectRoot, root, "skills", "prepare-composite-long-task"),
+        path.join(projectRoot, root, "skills", "composite-long-task-workflow"),
+        path.join(projectRoot, root, "ty-context-managed", "composite"),
+    ]) {
+        if (!(await pathExists(retired)))
+            continue;
+        await fs.rm(retired, { recursive: true, force: true });
+        report.changed.push(path.relative(projectRoot, retired).split(path.sep).join("/"));
+    }
+}
+async function verifyCompositeCodexProfile(projectRoot) {
+    const relative = await harnessConfigPath(projectRoot);
+    const raw = parseYaml(await readText(path.join(projectRoot, relative)));
+    const enabled = raw.profiles?.enabled ?? [];
+    if (enabled.includes("composite-codex") || !enabled.includes("long-task"))
+        throw new Error("composite-codex-to-long-task migration verification failed");
 }
 async function migrateDesignMd(projectRoot, _root, report) {
     if (await createDesignMdIfMissing(projectRoot)) {
@@ -325,7 +442,8 @@ async function detectConfigRefresh(projectRoot, root, migration) {
     }
     const config = await readConfig(projectRoot);
     const current = defaultConfig(root);
-    const managedMatches = JSON.stringify(config.managed_files) === JSON.stringify(current.managed_files);
+    const managedMatches = JSON.stringify(config.managed_files) ===
+        JSON.stringify(current.managed_files);
     const neverOverwriteHasDefaults = current.never_overwrite.every((entry) => config.never_overwrite.includes(entry));
     if (config.core.package === current.core.package &&
         config.core.schema_version === CURRENT_SCHEMA_VERSION &&
@@ -334,7 +452,7 @@ async function detectConfigRefresh(projectRoot, root, migration) {
         return [];
     }
     return [
-        item(migration, "safe_pending", relativeConfigPath, "Harness config needs current package metadata, schema version or managed-file defaults.")
+        item(migration, "safe_pending", relativeConfigPath, "Harness config needs current package metadata, schema version or managed-file defaults."),
     ];
 }
 async function migrateConfig(projectRoot, root, report) {
@@ -369,10 +487,15 @@ async function detectDeprecatedSkillOverrides(projectRoot, root, migration) {
 }
 async function ambiguousAreaContextFiles(projectRoot) {
     const areasRoot = path.join(projectRoot, "project_context", "areas");
-    const areaFiles = (await listFiles(areasRoot)).filter((file) => file.endsWith(".md")).sort();
+    const areaFiles = (await listFiles(areasRoot))
+        .filter((file) => file.endsWith(".md"))
+        .sort();
     const ambiguous = [];
     for (const file of areaFiles) {
-        const relativeToAreas = path.relative(areasRoot, file).split(path.sep).join("/");
+        const relativeToAreas = path
+            .relative(areasRoot, file)
+            .split(path.sep)
+            .join("/");
         if (!relativeToAreas.includes("/")) {
             continue;
         }
@@ -399,7 +522,7 @@ function item(migrationId, status, pathLabel, message) {
         scope: migration.scope,
         status,
         path: pathLabel,
-        message
+        message,
     };
 }
 function hasHeading(content, heading) {
@@ -413,7 +536,8 @@ function rewriteLegacyModuleReferences(content) {
 }
 function inferredRoleContext(relativeToAreas) {
     const normalized = relativeToAreas.toLowerCase();
-    if (normalized.endsWith("/verification.md") || normalized === "verification.md") {
+    if (normalized.endsWith("/verification.md") ||
+        normalized === "verification.md") {
         return "verification";
     }
     if (normalized.endsWith("/deployment.md") || normalized === "deployment.md") {

package/dist/lib/modularity.d.ts

@@ -7,9 +7,31 @@ export interface ModularityCheckOptions {
 export interface ModularityFileReport {
     relativePath: string;
     lines: number;
+    metrics: ModularityMetrics;
+    risks: string[];
+    regressions: string[];
     overLimit: boolean;
+    regressed: boolean;
+    baseline?: {
+        lines: number;
+        metrics: ModularityMetrics;
+        risks: string[];
+    };
     waived?: ModularityWaiver;
 }
+export interface ModularityMetricLocation {
+    symbol: string;
+    line: number;
+}
+export interface ModularityMetrics {
+    maxFunctionStatements: number;
+    maxFunctionStatementsLocation?: ModularityMetricLocation;
+    maxBranchComplexity: number;
+    maxBranchComplexityLocation?: ModularityMetricLocation;
+    exports: number;
+    stateTransitions: number;
+    responsibilities: string[];
+}
 export interface ModularityCheckReport {
     limit: number;
     files: ModularityFileReport[];
@@ -20,8 +42,12 @@ export interface ModularityCheckReport {
 export interface ModularityWaiver {
     relativePath: string;
     category: string;
+    owner: string;
+    introducedAt: string;
     reason: string;
-    futureSplitBoundary: string;
+    trackingIssue: string;
+    expiryCondition: string;
 }
 export declare function runModularityCheck(projectRoot: string, options: ModularityCheckOptions): Promise<ModularityCheckReport>;
+export declare function analyzeModularity(content: string, relativePath?: string): ModularityMetrics;
 export declare function countPhysicalLines(content: string): number;