project-tiny-context-harness 0.2.84 → 0.6.0

package/dist/lib/package-source.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged } from "./fs.js";
+import { ensureDir, listFiles, pathExists, readText, writeTextIfChanged, } from "./fs.js";
 import { AGENTS_BLOCK_MARKERS } from "./managed-file.js";
 import { SOURCE_MAPPINGS_PATH } from "./paths.js";
 import { parseYaml } from "./yaml.js";
@@ -29,7 +29,9 @@ export async function checkSource(projectRoot) {
         for (const item of expected) {
             sourceHashes.set(item.relative, hash(item.content));
             const targetFile = path.join(target, item.relative);
-            const existing = (await pathExists(targetFile)) ? await readText(targetFile) : "";
+            const existing = (await pathExists(targetFile))
+                ? await readText(targetFile)
+                : "";
             if (hash(existing) !== hash(item.content)) {
                 drift.push(`${mapping.target}/${item.relative}`);
             }
@@ -58,15 +60,25 @@ async function applyMapping(projectRoot, mapping) {
     if (typeof rendered === "string") {
         return (await writeTextIfChanged(target, rendered)) ? [mapping.target] : [];
     }
-    await fs.rm(target, { recursive: true, force: true });
     await ensureDir(target);
     const changed = [];
+    const expectedRelatives = new Set(rendered.map((item) => item.relative));
     for (const item of rendered) {
         const targetFile = path.join(target, item.relative);
         if (await writeTextIfChanged(targetFile, item.content)) {
             changed.push(`${mapping.target}/${item.relative}`);
         }
     }
+    for (const targetFile of await listFiles(target)) {
+        if (path.basename(targetFile) === ".gitkeep") {
+            continue;
+        }
+        const relative = path.relative(target, targetFile);
+        if (!expectedRelatives.has(relative)) {
+            await fs.rm(targetFile, { force: true });
+            changed.push(`${mapping.target}/${relative}`);
+        }
+    }
     return changed;
 }
 async function renderMapping(projectRoot, mapping) {

package/dist/lib/profiles.d.ts

@@ -0,0 +1,13 @@
+import type { HarnessConfig, HarnessProfile } from "./types.js";
+export declare const HARNESS_PROFILES: readonly HarnessProfile[];
+export declare function isProfileEnabled(config: HarnessConfig, profile: HarnessProfile): boolean;
+export declare function assertHarnessProfileEnabled(projectRoot: string, profile: HarnessProfile): Promise<void>;
+export declare function enableHarnessProfile(projectRoot: string, profile: string): Promise<{
+    changed: boolean;
+    config: HarnessConfig;
+}>;
+export declare function disableHarnessProfile(projectRoot: string, profile: string): Promise<{
+    changed: boolean;
+    config: HarnessConfig;
+}>;
+export declare function enabledManagedSkillNames(config: HarnessConfig): Set<string>;

package/dist/lib/profiles.js

@@ -0,0 +1,66 @@
+import path from "node:path";
+import { readConfig, writeConfigIfMissing } from "./config.js";
+import { harnessConfigPath } from "./harness-root.js";
+import { readText, writeTextIfChanged } from "./fs.js";
+import { parseYaml, stringifyYaml } from "./yaml.js";
+export const HARNESS_PROFILES = [
+    "core-portable",
+    "workflow-default",
+    "long-task",
+];
+export function isProfileEnabled(config, profile) {
+    return config.profiles.enabled.includes(profile);
+}
+export async function assertHarnessProfileEnabled(projectRoot, profile) {
+    const config = await readConfig(projectRoot);
+    if (!isProfileEnabled(config, profile)) {
+        throw new Error(`profile ${profile} is not enabled; run: ty-context enable ${profile}`);
+    }
+}
+export async function enableHarnessProfile(projectRoot, profile) {
+    if (!HARNESS_PROFILES.includes(profile)) {
+        throw new Error(`unknown profile ${profile}; expected one of ${HARNESS_PROFILES.join(", ")}`);
+    }
+    await writeConfigIfMissing(projectRoot);
+    const relative = await harnessConfigPath(projectRoot);
+    const file = path.join(projectRoot, relative);
+    const raw = parseYaml(await readText(file));
+    const existing = await readConfig(projectRoot);
+    const enabled = [
+        ...new Set([...existing.profiles.enabled, profile]),
+    ];
+    const next = { ...raw, profiles: { enabled } };
+    const changed = await writeTextIfChanged(file, stringifyYaml(next));
+    return { changed, config: await readConfig(projectRoot) };
+}
+export async function disableHarnessProfile(projectRoot, profile) {
+    if (profile !== "long-task") {
+        throw new Error("only long-task can be explicitly disabled");
+    }
+    await writeConfigIfMissing(projectRoot);
+    const relative = await harnessConfigPath(projectRoot);
+    const file = path.join(projectRoot, relative);
+    const raw = parseYaml(await readText(file));
+    const existing = await readConfig(projectRoot);
+    const enabled = existing.profiles.enabled.filter((item) => item !== profile);
+    const next = { ...raw, profiles: { enabled } };
+    const changed = await writeTextIfChanged(file, stringifyYaml(next));
+    return { changed, config: await readConfig(projectRoot) };
+}
+export function enabledManagedSkillNames(config) {
+    const names = new Set([
+        "context_development_engineer",
+        "context_full_project_export",
+        "context_harness_upgrade",
+        "context_product_plan",
+        "context_surface_contract",
+        "context_uiux_design",
+    ]);
+    if (isProfileEnabled(config, "workflow-default"))
+        names.add("normal-long-task");
+    if (isProfileEnabled(config, "long-task")) {
+        names.add("long-task-workflow");
+        names.add("source-plan-authoring");
+    }
+    return names;
+}

package/dist/lib/schema-guard.js

@@ -10,13 +10,15 @@ export async function assertSupportedSchema(projectRoot, commandName) {
 export function unsupportedSchemaMessage(schemaVersion, commandName) {
     const projectMajor = schemaMajor(schemaVersion);
     const supportedMajor = schemaMajor(CURRENT_SCHEMA_VERSION);
-    if (projectMajor === undefined || supportedMajor === undefined || projectMajor <= supportedMajor) {
+    if (projectMajor === undefined ||
+        supportedMajor === undefined ||
+        projectMajor <= supportedMajor) {
         return undefined;
     }
     return [
         `unsupported Harness schema version ${schemaVersion}; this CLI supports schema ${CURRENT_SCHEMA_VERSION}`,
         `Refusing to run ${commandName} because older CLI versions must not rewrite newer projects`,
-        `Use the canonical latest CLI: ${CANONICAL_NPX_COMMAND} ${commandName}`
+        `Use the canonical latest CLI: ${CANONICAL_NPX_COMMAND} ${commandName}`,
     ].join(". ");
 }
 export function schemaMajor(schemaVersion) {

package/dist/lib/source-files.js

@@ -23,9 +23,15 @@ const EXCLUDED_DIR_NAMES = new Set([
     "temp",
     "test-reports",
     "test-results",
-    "tmp"
+    "tmp",
+]);
+export const SAFE_EXAMPLE_FILE_NAMES = new Set([
+    ".env.example",
+    ".env.sample",
+    ".env.template",
+    "example.env",
+    "sample.env",
 ]);
-export const SAFE_EXAMPLE_FILE_NAMES = new Set([".env.example", ".env.sample", ".env.template", "example.env", "sample.env"]);
 const EXCLUDED_FILE_PATTERNS = [
     /^\.env(?:\.|$)/i,
     /\.log$/i,
@@ -36,7 +42,7 @@ const EXCLUDED_FILE_PATTERNS = [
     /full-project-context-\d{8}T\d{6}Z\.md$/i,
     /当前项目context-\d{8}T\d{6}Z\.md$/i,
     /当前项目代码实现\.md$/i,
-    /(^|[-_.])(code-level-implementation|context-export|context-bundle)([-_.]|$)/i
+    /(^|[-_.])(code-level-implementation|context-export|context-bundle)([-_.]|$)/i,
 ];
 const CODE_FILE_EXTENSIONS = [
     ".bat",
@@ -59,7 +65,7 @@ const CODE_FILE_EXTENSIONS = [
     ".tsx",
     ".vue",
     ".yaml",
-    ".yml"
+    ".yml",
 ];
 const CODE_FILE_BASE_NAMES = new Set([
     ".env.example",
@@ -71,7 +77,7 @@ const CODE_FILE_BASE_NAMES = new Set([
     "pyproject.toml",
     "requirements.txt",
     "setup.cfg",
-    "tsconfig.json"
+    "tsconfig.json",
 ]);
 const CONFIG_JSON_NAMES = new Set([
     "babel.config.json",
@@ -82,7 +88,7 @@ const CONFIG_JSON_NAMES = new Set([
     "jsconfig.json",
     "package.json",
     "tsconfig.json",
-    "vite.config.json"
+    "vite.config.json",
 ]);
 export function shouldIncludeCodeFile(relative) {
     if (shouldExcludeRelativePath(relative)) {
@@ -111,7 +117,8 @@ export function shouldExcludeRelativePath(relative) {
     const base = segments[segments.length - 1] ?? "";
     const lowerBase = base.toLowerCase();
     return EXCLUDED_FILE_PATTERNS.some((pattern) => {
-        if (SAFE_EXAMPLE_FILE_NAMES.has(lowerBase) && pattern.source.startsWith("^\\.env")) {
+        if (SAFE_EXAMPLE_FILE_NAMES.has(lowerBase) &&
+            pattern.source.startsWith("^\\.env")) {
             return false;
         }
         return pattern.test(base) || pattern.test(normalized);

package/dist/lib/source-pack-classify.js

@@ -12,7 +12,7 @@ export function classifyCodeFile(relative, content, areas) {
         tags,
         routes,
         score: scoreFor(tags, relative),
-        bucket: routingBucket(relative, areas)
+        bucket: routingBucket(relative, areas),
     };
 }
 function tagsFor(relative, content, language, routes) {
@@ -27,7 +27,8 @@ function tagsFor(relative, content, language, routes) {
         tags.add("cli");
     if (/worker|scheduler|queue|runtime|cron|job/.test(lower))
         tags.add("worker");
-    if (/schema|contract|types?\.|\.d\.ts$/.test(lower) || /\b(interface|type|schema)\b/.test(content))
+    if (/schema|contract|types?\.|\.d\.ts$/.test(lower) ||
+        /\b(interface|type|schema)\b/.test(content))
         tags.add("contract");
     if (/pages|views|screens|components|\.vue$|\.tsx$|\.jsx$/.test(lower))
         tags.add("ui");
@@ -40,12 +41,25 @@ function tagsFor(relative, content, language, routes) {
     return [...tags].sort();
 }
 function scoreFor(tags, relative) {
-    const weights = { entry: 50, api: 35, cli: 32, worker: 30, contract: 28, ui: 24, test: 18, config: 12, oversized: -15 };
-    return tags.reduce((sum, tag) => sum + (weights[tag] ?? 0), 0) + Math.max(0, 20 - relative.split("/").length);
+    const weights = {
+        entry: 50,
+        api: 35,
+        cli: 32,
+        worker: 30,
+        contract: 28,
+        ui: 24,
+        test: 18,
+        config: 12,
+        oversized: -15,
+    };
+    return (tags.reduce((sum, tag) => sum + (weights[tag] ?? 0), 0) +
+        Math.max(0, 20 - relative.split("/").length));
 }
 function routingBucket(relative, areas) {
     for (const area of areas) {
-        if (area.root === "." || relative === area.root || relative.startsWith(`${area.root}/`)) {
+        if (area.root === "." ||
+            relative === area.root ||
+            relative.startsWith(`${area.root}/`)) {
             return `area:${area.id}`;
         }
     }
@@ -62,11 +76,17 @@ function summarizeCodeFile(relative, content, language) {
     const symbols = extractSymbolSummary(content, language);
     if (base === "package.json") {
         const packageName = /"name"\s*:\s*"([^"]+)"/.exec(content)?.[1];
-        return packageName ? `Defines npm package ${packageName} metadata, scripts and dependencies.` : "Defines npm package metadata, scripts and dependencies.";
+        return packageName
+            ? `Defines npm package ${packageName} metadata, scripts and dependencies.`
+            : "Defines npm package metadata, scripts and dependencies.";
     }
     if (base.toLowerCase() === "makefile") {
-        const targets = [...content.matchAll(/^([A-Za-z0-9_.-]+):/gm)].map((match) => match[1]).slice(0, 6);
-        return targets.length > 0 ? `Defines Make targets ${targets.join(", ")}.` : "Defines Make targets for local automation.";
+        const targets = [...content.matchAll(/^([A-Za-z0-9_.-]+):/gm)]
+            .map((match) => match[1])
+            .slice(0, 6);
+        return targets.length > 0
+            ? `Defines Make targets ${targets.join(", ")}.`
+            : "Defines Make targets for local automation.";
     }
     if (symbols.length > 0) {
         return `${describeFilePurpose(relative, language)}; exposes ${symbols.slice(0, 6).join(", ")}.`;
@@ -75,15 +95,21 @@ function summarizeCodeFile(relative, content, language) {
 }
 function extractSymbolSummary(content, language) {
     const patterns = language === "python"
-        ? [/^(?:async\s+)?def\s+([A-Za-z_][\w]*)/gm, /^class\s+([A-Za-z_][\w]*)/gm]
+        ? [
+            /^(?:async\s+)?def\s+([A-Za-z_][\w]*)/gm,
+            /^class\s+([A-Za-z_][\w]*)/gm,
+        ]
         : language === "go"
-            ? [/^func\s+(?:\([^)]+\)\s*)?([A-Za-z_][\w]*)/gm, /^type\s+([A-Za-z_][\w]*)/gm]
+            ? [
+                /^func\s+(?:\([^)]+\)\s*)?([A-Za-z_][\w]*)/gm,
+                /^type\s+([A-Za-z_][\w]*)/gm,
+            ]
             : [
                 /(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/g,
                 /(?:export\s+)?class\s+([A-Za-z_$][\w$]*)/g,
                 /(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)/g,
                 /(?:export\s+)?type\s+([A-Za-z_$][\w$]*)/g,
-                /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)/g
+                /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)/g,
             ];
     const symbols = new Set();
     for (const pattern of patterns) {
@@ -99,42 +125,88 @@ function extractSymbolSummary(content, language) {
 }
 function extractRouteSummary(content) {
     const routes = new Set();
-    const patterns = [/\.(get|post|put|patch|delete|head|options)\s*\(\s*["'`]([^"'`]+)["'`]/gi, /\bHandle(?:Func)?\s*\(\s*["'`]([^"'`]+)["'`]/g];
+    const patterns = [
+        /\.(get|post|put|patch|delete|head|options)\s*\(\s*["'`]([^"'`]+)["'`]/gi,
+        /\bHandle(?:Func)?\s*\(\s*["'`]([^"'`]+)["'`]/g,
+    ];
     for (const pattern of patterns) {
         let match;
         while ((match = pattern.exec(content)) && routes.size < 8) {
-            routes.add(match.length === 3 ? `${match[1].toUpperCase()} ${match[2]}` : `route ${match[1]}`);
+            routes.add(match.length === 3
+                ? `${match[1].toUpperCase()} ${match[2]}`
+                : `route ${match[1]}`);
         }
     }
     return [...routes].sort();
 }
 function describeFilePurpose(relative, language) {
     const lower = relative.toLowerCase();
-    if (lower.includes("/test") || lower.includes(".test.") || lower.includes(".spec."))
+    if (lower.includes("/test") ||
+        lower.includes(".test.") ||
+        lower.includes(".spec."))
         return `Contains ${language} tests for ${path.posix.basename(relative)}`;
     if (lower.includes("/commands/"))
         return `Implements ${language} command handling for ${path.posix.basename(relative)}`;
-    if (lower.includes("/cli") || lower.endsWith("/cli.ts") || lower.endsWith("/cli.js"))
+    if (lower.includes("/cli") ||
+        lower.endsWith("/cli.ts") ||
+        lower.endsWith("/cli.js"))
         return `Implements ${language} CLI behavior for ${path.posix.basename(relative)}`;
-    if (lower.includes("/components/") || lower.includes("/pages/") || lower.includes("/views/"))
+    if (lower.includes("/components/") ||
+        lower.includes("/pages/") ||
+        lower.includes("/views/"))
         return `Implements ${language} UI behavior for ${path.posix.basename(relative)}`;
     return `Contains ${language} implementation for ${path.posix.basename(relative)}`;
 }
 function isLikelyEntrypoint(relative) {
     const lower = relative.toLowerCase();
     const base = path.posix.basename(lower);
-    return ["package.json", "makefile", "dockerfile", "main.go", "app.py", "server.py", "index.ts", "index.js", "cli.ts", "cli.js"].includes(base) || /\/src\/(main|app|index)\.[tj]sx?$/.test(lower);
+    return ([
+        "package.json",
+        "makefile",
+        "dockerfile",
+        "main.go",
+        "app.py",
+        "server.py",
+        "index.ts",
+        "index.js",
+        "cli.ts",
+        "cli.js",
+    ].includes(base) || /\/src\/(main|app|index)\.[tj]sx?$/.test(lower));
 }
 function languageFor(relative) {
     const lower = relative.toLowerCase();
     const base = path.posix.basename(lower);
     if (base === "makefile")
         return "make";
-    if (base === "dockerfile" || base.startsWith("dockerfile.") || lower.endsWith(".dockerfile"))
+    if (base === "dockerfile" ||
+        base.startsWith("dockerfile.") ||
+        lower.endsWith(".dockerfile"))
         return "dockerfile";
     if (SAFE_EXAMPLE_FILE_NAMES.has(base))
         return "dotenv";
-    for (const [extension, language] of [[".tsx", "tsx"], [".ts", "typescript"], [".jsx", "jsx"], [".js", "javascript"], [".mjs", "javascript"], [".py", "python"], [".go", "go"], [".vue", "vue"], [".sql", "sql"], [".json", "json"], [".jsonc", "jsonc"], [".yaml", "yaml"], [".yml", "yaml"], [".toml", "toml"], [".sh", "bash"], [".ps1", "powershell"], [".cmd", "batch"], [".bat", "batch"], [".graphql", "graphql"], [".gql", "graphql"], [".proto", "protobuf"]]) {
+    for (const [extension, language] of [
+        [".tsx", "tsx"],
+        [".ts", "typescript"],
+        [".jsx", "jsx"],
+        [".js", "javascript"],
+        [".mjs", "javascript"],
+        [".py", "python"],
+        [".go", "go"],
+        [".vue", "vue"],
+        [".sql", "sql"],
+        [".json", "json"],
+        [".jsonc", "jsonc"],
+        [".yaml", "yaml"],
+        [".yml", "yaml"],
+        [".toml", "toml"],
+        [".sh", "bash"],
+        [".ps1", "powershell"],
+        [".cmd", "batch"],
+        [".bat", "batch"],
+        [".graphql", "graphql"],
+        [".gql", "graphql"],
+        [".proto", "protobuf"],
+    ]) {
         if (lower.endsWith(extension))
             return language;
     }

package/dist/lib/source-pack-config.js

@@ -12,9 +12,15 @@ export async function readSourcePackProfile(projectRoot, profileId) {
         throw new Error(`source pack profile not found: ${profileId}`);
     }
     const parsed = parseYaml(await readText(configPath));
-    const sourcePacks = parsed && typeof parsed === "object" ? parsed.source_packs : undefined;
-    const profileValue = sourcePacks && typeof sourcePacks === "object" ? sourcePacks[profileId] : undefined;
-    if (!profileValue || typeof profileValue !== "object" || Array.isArray(profileValue)) {
+    const sourcePacks = parsed && typeof parsed === "object"
+        ? parsed.source_packs
+        : undefined;
+    const profileValue = sourcePacks && typeof sourcePacks === "object"
+        ? sourcePacks[profileId]
+        : undefined;
+    if (!profileValue ||
+        typeof profileValue !== "object" ||
+        Array.isArray(profileValue)) {
         throw new Error(`source pack profile not found: ${profileId}`);
     }
     const value = profileValue;
@@ -23,7 +29,7 @@ export async function readSourcePackProfile(projectRoot, profileId) {
         code: readPatternList(value.code, `source_packs.${profileId}.code`, "code path"),
         exclude: readPatternList(value.exclude, `source_packs.${profileId}.exclude`, "exclude path"),
         verification: readStringList(value.verification, `source_packs.${profileId}.verification`),
-        maxBundleCharacters: readPositiveInteger(value.max_bundle_characters, `source_packs.${profileId}.max_bundle_characters`)
+        maxBundleCharacters: readPositiveInteger(value.max_bundle_characters, `source_packs.${profileId}.max_bundle_characters`),
     };
 }
 export async function parseContextAreas(projectRoot) {
@@ -38,13 +44,21 @@ export async function parseContextAreas(projectRoot) {
         const root = /root\s*=\s*"([^"]+)"/.exec(block)?.[1];
         const context = /context\s*=\s*"([^"]+)"/.exec(block)?.[1];
         if (id && root && context) {
-            areas.push({ id, root: normalizeRepoPath(root, "area root"), context: normalizeRepoPath(context, "area context") });
+            areas.push({
+                id,
+                root: normalizeRepoPath(root, "area root"),
+                context: normalizeRepoPath(context, "area context"),
+            });
         }
     }
     return areas.sort((left, right) => left.id.localeCompare(right.id));
 }
 export function mergePatterns(...groups) {
-    return [...new Set(groups.flatMap((group) => group ?? []).map((value) => normalizeRepoPath(value, "include path")))].sort();
+    return [
+        ...new Set(groups
+            .flatMap((group) => group ?? [])
+            .map((value) => normalizeRepoPath(value, "include path"))),
+    ].sort();
 }
 export function validatePatternList(values, label) {
     return values.map((value) => normalizeRepoPath(value, label));
@@ -66,7 +80,8 @@ function readStringList(value, label) {
     if (value === undefined) {
         return [];
     }
-    if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item.trim().length === 0)) {
+    if (!Array.isArray(value) ||
+        value.some((item) => typeof item !== "string" || item.trim().length === 0)) {
         throw new Error(`<harnessRoot>/config.yaml ${label} must be an array of non-empty strings`);
     }
     return value.map((item) => item.trim());
@@ -81,7 +96,9 @@ function readPositiveInteger(value, label) {
     return Number(value);
 }
 function isAllowedPatternPath(value) {
-    return value.length > 0 && !path.posix.isAbsolute(value) && !value.split("/").includes("..");
+    return (value.length > 0 &&
+        !path.posix.isAbsolute(value) &&
+        !value.split("/").includes(".."));
 }
 function globToRegExp(pattern) {
     const escaped = pattern