project-tiny-context-harness 0.8.17 → 0.12.0

package/dist/commands/check-modularity.js

@@ -1,181 +0,0 @@
-import { runModularityCheck } from "../lib/modularity.js";
-export async function checkModularity(args) {
-    let parsed;
-    try {
-        parsed = parseArgs(args);
-    }
-    catch (error) {
-        console.error(`error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exitCode = 1;
-        return;
-    }
-    if (parsed.help ||
-        (!parsed.configOnly &&
-            !parsed.touched &&
-            !parsed.base &&
-            parsed.files.length === 0)) {
-        console.log(helpText());
-        if (!parsed.help) {
-            process.exitCode = 1;
-        }
-        return;
-    }
-    try {
-        const report = await runModularityCheck(process.cwd(), {
-            touched: parsed.touched,
-            base: parsed.base,
-            files: parsed.files,
-            limit: parsed.limit,
-        });
-        console.log(`check-modularity audited=${report.files.length} warning=${report.warnings.length} limit=${report.limit} waived=${report.waivedWarnings.length}`);
-        if (report.files.length === 0) {
-            console.log("No handwritten source files matched the selected scope.");
-        }
-        for (const file of report.files) {
-            const prefix = file.regressed && file.waived
-                ? "waived"
-                : file.regressed
-                    ? "over-limit"
-                    : file.overLimit
-                        ? "observed-risk"
-                        : "ok";
-            console.log(`${prefix}: ${file.relativePath} ${file.lines} lines analysis=${file.metrics.analysis} statements=${formatMetric(file.metrics.maxFunctionStatements)} branches=${formatMetric(file.metrics.maxBranchComplexity)} exports=${formatMetric(file.metrics.exports)} transitions=${formatMetric(file.metrics.stateTransitions)} responsibilities=${formatResponsibilities(file.metrics.responsibilities)} statement_at=${formatLocation(file.metrics.maxFunctionStatementsLocation, file.metrics.maxFunctionStatements !== null)} branch_at=${formatLocation(file.metrics.maxBranchComplexityLocation, file.metrics.maxBranchComplexity !== null)}`);
-        }
-        for (const error of report.errors) {
-            console.error(`error: ${error}`);
-        }
-        for (const warning of report.warnings) {
-            console.warn(`warning: ${warning}`);
-        }
-        for (const waiver of report.waivedWarnings) {
-            console.warn(`waived: ${waiver}`);
-        }
-        if (report.warnings.length > 0) {
-            console.warn("warning: modularity risks need a split or, when modularity.policy is scoped_waivers, a valid <harnessRoot>/config.yaml waiver with path, category, owner, introduced_at, reason, tracking_issue and expiry_condition.");
-        }
-        if (report.errors.length > 0 ||
-            (report.warnings.length > 0 && parsed.failOnWarning)) {
-            process.exitCode = 1;
-        }
-    }
-    catch (error) {
-        console.error(`error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exitCode = 1;
-    }
-}
-function formatLocation(location, supported) {
-    if (!supported) {
-        return "n/a";
-    }
-    return location ? `${location.symbol}:${location.line}` : "none";
-}
-function formatMetric(value) {
-    return value === null ? "n/a" : String(value);
-}
-function formatResponsibilities(value) {
-    if (value === null) {
-        return "n/a";
-    }
-    return value.join(",") || "none";
-}
-function parseArgs(args) {
-    const parsed = {
-        touched: false,
-        files: [],
-        limit: 300,
-        failOnWarning: false,
-        configOnly: false,
-        help: false,
-    };
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === "--touched") {
-            parsed.touched = true;
-            continue;
-        }
-        if (arg === "--fail-on-warning") {
-            parsed.failOnWarning = true;
-            continue;
-        }
-        if (arg === "--config-only") {
-            parsed.configOnly = true;
-            continue;
-        }
-        if (arg === "--help" || arg === "-h") {
-            parsed.help = true;
-            continue;
-        }
-        if (arg === "--file") {
-            const value = args[index + 1];
-            if (!value || value.startsWith("--")) {
-                throw new Error("check-modularity --file requires a path");
-            }
-            parsed.files.push(value);
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--file=")) {
-            const value = arg.slice("--file=".length).trim();
-            if (!value) {
-                throw new Error("check-modularity --file requires a path");
-            }
-            parsed.files.push(value);
-            continue;
-        }
-        if (arg === "--base") {
-            const value = args[index + 1];
-            if (!value || value.startsWith("--")) {
-                throw new Error("check-modularity --base requires a ref");
-            }
-            parsed.base = value;
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--base=")) {
-            const value = arg.slice("--base=".length).trim();
-            if (!value) {
-                throw new Error("check-modularity --base requires a ref");
-            }
-            parsed.base = value;
-            continue;
-        }
-        if (arg === "--limit") {
-            const value = args[index + 1];
-            if (!value || value.startsWith("--")) {
-                throw new Error("check-modularity --limit requires a positive integer");
-            }
-            parsed.limit = parseLimit(value);
-            index += 1;
-            continue;
-        }
-        if (arg.startsWith("--limit=")) {
-            parsed.limit = parseLimit(arg.slice("--limit=".length));
-            continue;
-        }
-        throw new Error(`unknown check-modularity argument: ${arg}`);
-    }
-    return parsed;
-}
-function parseLimit(value) {
-    const limit = Number.parseInt(value, 10);
-    if (!Number.isInteger(limit) ||
-        limit <= 0 ||
-        String(limit) !== value.trim()) {
-        throw new Error("check-modularity --limit requires a positive integer");
-    }
-    return limit;
-}
-function helpText() {
-    return `ty-context check-modularity:
-  check-modularity --touched [--limit 300] [--fail-on-warning]
-  check-modularity --file <path> [--file <path> ...] [--limit 300] [--fail-on-warning]
-  check-modularity --base <ref> [--limit 300] [--fail-on-warning]
-  check-modularity --config-only
-
-Portable heuristic risk signal: all selected files get physical-line analysis; JS/TS gets lexical function/branch/export/state-transition/responsibility metrics; Python gets lexical per-function statement/branch metrics; other included formats are line-only.
-The report names analysis=js-ts-heuristic|python-heuristic|line-only and prints n/a for unsupported metrics. It is not complete cross-language static analysis, architecture proof or runtime-performance evidence; prefer project-native tools for those claims.
-For --touched and --base, existing findings are reported but only new or worsened non-line complexity is a warning; physical lines remain a risk signal and new files are audited in full.
-The default is warning-only; --fail-on-warning lets projects opt into CI enforcement.
-Generated configs default to modularity.policy: strict_except_generated; omitted policy is treated as scoped_waivers for compatibility.
-Risks can be waived only through lifecycle-complete <harnessRoot>/config.yaml modularity.waivers when policy is scoped_waivers.`;
-}

package/dist/commands/composite-campaign.d.ts

@@ -1 +0,0 @@
-export declare function compositeCampaign(_args: string[]): void;

package/dist/commands/composite-campaign.js

@@ -1,8 +0,0 @@
-export function compositeCampaign(_args) {
-    console.log(JSON.stringify({
-        status: "retired",
-        command: "composite-campaign",
-        next_command: "ty-context long-task",
-        historical_state_executed: false,
-    }));
-}

package/dist/commands/composite-long-task.d.ts

@@ -1 +0,0 @@
-export declare function compositeLongTask(_args: string[]): void;

package/dist/commands/composite-long-task.js

@@ -1,8 +0,0 @@
-export function compositeLongTask(_args) {
-    console.log(JSON.stringify({
-        status: "retired",
-        command: "composite-long-task",
-        next_command: "ty-context long-task",
-        historical_state_executed: false,
-    }));
-}

package/dist/commands/delivery-set.d.ts

@@ -1 +0,0 @@
-export declare function deliverySet(_args: string[]): void;

package/dist/commands/delivery-set.js

@@ -1,8 +0,0 @@
-const TOMBSTONE = {
-    status: "retired",
-    reason: "Delivery Set orchestration is outside the minimal Single-Goal core.",
-    replacement: "Use one complete Delivery Contract with semantic Outcomes and one Final Gate.",
-};
-export function deliverySet(_args) {
-    console.log(JSON.stringify(TOMBSTONE));
-}

package/dist/commands/design-resource-recovery.d.ts

@@ -1 +0,0 @@
-export declare function designResourceRecoveryCommand(args: string[]): Promise<void>;

package/dist/commands/design-resource-recovery.js

@@ -1,152 +0,0 @@
-import { parseDesignResourceRecoveryCreateInput } from "../lib/design-resource-recovery-codec.js";
-import { readRecoveryRepositoryFile } from "../lib/design-resource-recovery-files.js";
-import { applyDesignResourceRecoveryWriteback, createDesignResourceRecoveryCheckpoint, inspectDesignResourceRecovery, previewDesignResourceRecoveryWriteback, reconcileDesignResourceRecovery, removeDesignResourceRecoveryCheckpoint, updateDesignResourceRecoveryCheckpoint, } from "../lib/design-resource-recovery.js";
-import { canonicalJson } from "../lib/strict-codec.js";
-export async function designResourceRecoveryCommand(args) {
-    const [action, sessionId, ...rest] = args;
-    if (!action || !sessionId)
-        throw new Error("usage: ty-context design-resource recovery <create|update|inspect|preview|apply|reconcile|remove> <session> [options]");
-    const options = recoveryOptions(rest);
-    let result;
-    if (action === "create")
-        result = await create(process.cwd(), sessionId, options);
-    else if (action === "update")
-        result = await update(process.cwd(), sessionId, options);
-    else if (action === "inspect") {
-        assertNoValueOptions(options, action);
-        result = await inspectDesignResourceRecovery(process.cwd(), sessionId);
-    }
-    else if (action === "preview") {
-        assertNoValueOptions(options, action);
-        result = await previewDesignResourceRecoveryWriteback(process.cwd(), sessionId);
-    }
-    else if (action === "apply")
-        result = await apply(process.cwd(), sessionId, options);
-    else if (action === "reconcile")
-        result = await reconcile(process.cwd(), sessionId, options);
-    else if (action === "remove")
-        result = await remove(process.cwd(), sessionId, options);
-    else
-        throw new Error(`Unknown design-resource recovery action: ${action}`);
-    if (options.json)
-        process.stdout.write(canonicalJson(result));
-    else
-        printRecoveryResult(action, result);
-    if ((action === "apply" || action === "reconcile") &&
-        result.status === "blocked")
-        process.exitCode = 2;
-    if (action === "remove" &&
-        result.status === "partial")
-        process.exitCode = 2;
-}
-async function create(repository, sessionId, options) {
-    if (!options.input || options.audit || options.expectedSha256)
-        usage("create <session> --input <state.json>");
-    const input = await readCreateInput(repository, options.input);
-    if (input.session_id !== sessionId)
-        throw new Error("design_resource_recovery_invalid:create_session_identity_mismatch");
-    return createDesignResourceRecoveryCheckpoint(repository, input);
-}
-async function apply(repository, sessionId, options) {
-    if (!options.audit || options.input || options.expectedSha256)
-        usage("apply <session> --audit <audit.json>");
-    return applyDesignResourceRecoveryWriteback(repository, sessionId, options.audit);
-}
-async function reconcile(repository, sessionId, options) {
-    if (!options.audit || options.input || options.expectedSha256)
-        usage("reconcile <session> --audit <audit.json>");
-    return reconcileDesignResourceRecovery(repository, sessionId, options.audit);
-}
-async function update(repository, sessionId, options) {
-    if (!options.input || !options.expectedSha256 || options.audit)
-        usage("update <session> --input <state.json> --expected-sha256 <sha256>");
-    const input = await readCreateInput(repository, options.input);
-    if (input.session_id !== sessionId)
-        throw new Error("design_resource_recovery_invalid:update_session_identity_mismatch");
-    return updateDesignResourceRecoveryCheckpoint(repository, input, options.expectedSha256);
-}
-async function remove(repository, sessionId, options) {
-    if (!options.expectedSha256 || options.input || options.audit)
-        usage("remove <session> --expected-sha256 <sha256>");
-    return removeDesignResourceRecoveryCheckpoint(repository, sessionId, options.expectedSha256);
-}
-function recoveryOptions(args) {
-    const result = { json: false };
-    for (let index = 0; index < args.length; index += 1) {
-        const item = args[index];
-        if (item === "--json") {
-            result.json = true;
-            continue;
-        }
-        const value = args[index + 1];
-        if (!value || value.startsWith("--"))
-            throw new Error(`${item} requires a value`);
-        if (item === "--input")
-            result.input = value;
-        else if (item === "--audit")
-            result.audit = value;
-        else if (item === "--expected-sha256")
-            result.expectedSha256 = value;
-        else
-            throw new Error(`Unknown design-resource recovery option: ${item}`);
-        index += 1;
-    }
-    return result;
-}
-function assertNoValueOptions(options, action) {
-    if (options.input || options.audit || options.expectedSha256)
-        usage(`${action} <session>`);
-}
-function usage(value) {
-    throw new Error(`usage: ty-context design-resource recovery ${value} [--json]`);
-}
-async function readCreateInput(repository, locator) {
-    const inputSnapshot = await readRecoveryRepositoryFile(repository, locator, "design_resource_recovery_create_input");
-    return parseDesignResourceRecoveryCreateInput(inputSnapshot.bytes.toString("utf8"));
-}
-function printRecoveryResult(action, result) {
-    const row = result;
-    if (action === "create" || action === "update") {
-        console.log(`DRA recovery checkpoint: ${row.status}`);
-        console.log(`Path: ${row.checkpoint_path}`);
-        console.log(`SHA-256: ${row.checkpoint_raw_byte_digest}`);
-        return;
-    }
-    if (action === "inspect" || action === "preview") {
-        printInspection(row);
-        if (action === "preview")
-            printPatch(row);
-        return;
-    }
-    if (action === "apply") {
-        console.log(`DRA writeback: ${row.status}`);
-        console.log(`Write transaction: ${row.write_transaction}`);
-        console.log(`Reconciliation: ${JSON.stringify(row.reconciliation)}`);
-        return;
-    }
-    if (action === "reconcile") {
-        console.log(`DRA reconciliation: ${row.status}`);
-        console.log(`Write transaction: ${row.write_transaction}`);
-        console.log(`Reconciliation: ${JSON.stringify(row.reconciliation)}`);
-        return;
-    }
-    console.log(`DRA recovery cleanup: ${row.status}`);
-    console.log(`Path: ${row.path}`);
-    if (row.status === "partial")
-        console.log(`Retained: ${JSON.stringify(row.retained_entries)}`);
-}
-function printInspection(row) {
-    const replay = row.replay;
-    console.log(`Base: ${replay.base.locator}@${replay.base.raw_byte_digest}`);
-    console.log(`Delta: ${replay.ordered_active_accepted_deltas.length} accepted / ${replay.rejected_deltas.length} rejected / ${replay.unresolved_deltas.length} unresolved`);
-    console.log(`Explicitly unchanged: ${replay.explicitly_unchanged_keys.join(", ") || "none"}`);
-    console.log(`Writeback: ${JSON.stringify(row.writeback)}`);
-}
-function printPatch(row) {
-    const patch = row.patch;
-    for (const operation of patch.patch.operations) {
-        console.log(`Patch ${operation.operation_id} [${operation.target_key}]:`);
-        console.log(`- ${operation.before_text}`);
-        console.log(`+ ${operation.after_text}`);
-    }
-}

package/dist/commands/design-resource.d.ts

@@ -1 +0,0 @@
-export declare function designResource(args: string[]): Promise<void>;

package/dist/commands/design-resource.js

@@ -1,125 +0,0 @@
-import { publishDesignResourceHandoffBundle } from "../lib/design-resource-handoff-bundle.js";
-import { preflightDesignResourceHandoff } from "../lib/design-resource-handoff-validation.js";
-import { designResourceRecoveryCommand } from "./design-resource-recovery.js";
-import { normalizeRepositoryCwd, normalizeRepositoryFile, } from "../lib/long-task-paths.js";
-import { canonicalJson } from "../lib/strict-codec.js";
-export async function designResource(args) {
-    const [subcommand = "help", ...rest] = args;
-    if (subcommand === "help") {
-        help();
-        return;
-    }
-    if (subcommand === "bundle") {
-        await bundle(rest);
-        return;
-    }
-    if (subcommand === "recovery") {
-        await designResourceRecoveryCommand(rest);
-        return;
-    }
-    if (subcommand !== "preflight")
-        throw new Error(`Unknown design-resource subcommand: ${subcommand}`);
-    const json = rest.includes("--json");
-    const positional = rest.filter((item) => item !== "--json");
-    if (positional.length !== 1)
-        throw new Error("usage: ty-context design-resource preflight <handoff.md> [--json]");
-    const handoffPath = normalizeRepositoryFile(positional[0], "design_resource_handoff");
-    const result = await preflightDesignResourceHandoff(process.cwd(), handoffPath);
-    if (json) {
-        process.stdout.write(canonicalJson(result));
-        return;
-    }
-    console.log(`Design resource handoff preflight valid: ${result.handoff_path}`);
-    console.log("Input closure: valid");
-    console.log(`Scope: ${result.handoff.scope.key}`);
-    console.log(`Targets: ${result.handoff.targets.map((item) => item.key).join(", ")}`);
-    console.log(`Technical feasibility inputs: ${result.technical_feasibility_identities.length}`);
-    console.log(`Technical feasibility cells: ${result.technical_feasibility_identities.reduce((total, item) => total + item.component_family_cells, 0)}`);
-    console.log(`Technical feasibility blockers: ${result.technical_feasibility_identities.reduce((total, item) => total + item.blockers, 0)}`);
-    console.log(`Limitations: ${result.limitations.length ? result.limitations.join("; ") : "none"}`);
-    console.log("Production conformance: not evaluated");
-    if ("metrics" in result) {
-        console.log(`Coverage: ${result.manifest.subjects.length} subjects x ${result.manifest.properties.length} atomic properties (${result.rule_projections.length} symbolic Rules)`);
-        console.log(`Symbolic: ${result.metrics.semantic_obligations} semantic obligations, ${result.metrics.certificate_obligations} certificates, ${result.metrics.canonical_dag_nodes} DAG nodes, ${result.metrics.canonical_bytes} bytes`);
-        console.log(`Acceptance blockers: ${result.manifest.acceptance_blockers.length}`);
-    }
-    else {
-        console.log(`Coverage: ${result.counts.subjects} subjects x 8 dimensions (${result.counts.coverage} grouped rows)`);
-        console.log(`Acceptance blockers: ${result.counts.acceptance_blockers}`);
-    }
-}
-async function bundle(args) {
-    const positional = [];
-    const manifests = [];
-    let maxHandoffBytes = null;
-    let json = false;
-    for (let index = 0; index < args.length; index += 1) {
-        const item = args[index];
-        if (item === "--json") {
-            json = true;
-            continue;
-        }
-        if (item === "--manifest") {
-            const value = args[index + 1];
-            if (!value)
-                throw new Error("--manifest requires a path");
-            manifests.push(normalizeRepositoryFile(value, "design_resource_bundle_manifest"));
-            index += 1;
-            continue;
-        }
-        if (item === "--max-handoff-bytes") {
-            const value = args[index + 1];
-            if (!value)
-                throw new Error("--max-handoff-bytes requires an integer");
-            maxHandoffBytes = Number(value);
-            index += 1;
-            continue;
-        }
-        if (item.startsWith("--"))
-            throw new Error(`Unknown design-resource bundle option: ${item}`);
-        positional.push(item);
-    }
-    if (positional.length !== 2 ||
-        manifests.length === 0 ||
-        maxHandoffBytes === null)
-        throw new Error("usage: ty-context design-resource bundle <draft-dir> <new-output-dir> --manifest <facts.json> [--manifest <facts.json> ...] --max-handoff-bytes <bytes> [--json]");
-    const result = await publishDesignResourceHandoffBundle({
-        repository: process.cwd(),
-        draft_directory: normalizeRepositoryCwd(positional[0], "design_resource_bundle_draft_directory"),
-        output_directory: normalizeRepositoryCwd(positional[1], "design_resource_bundle_output_directory"),
-        manifest_paths: manifests,
-        max_handoff_bytes: maxHandoffBytes,
-    });
-    if (json) {
-        process.stdout.write(canonicalJson(result));
-        return;
-    }
-    console.log(`Design resource Source bundle published: ${result.output_directory}`);
-    console.log("Production readiness: not evaluated");
-    console.log(`Handoffs: ${result.handoffs.length}`);
-    console.log(`Targets: ${result.handoffs.map((item) => item.target_key).join(", ")}`);
-}
-function help() {
-    console.log(`ty-context design-resource commands:
-  preflight <handoff.md> [--json]
-                       Validate one selected implementation handoff
-  bundle <draft-dir> <new-output-dir> --manifest <facts.json> [...]
-         --max-handoff-bytes <bytes> [--json]
-                       Validate manifest-backed one-target handoffs and
-                       atomically publish the complete target set; the
-                       output parent directory must already exist
-  recovery create <session> --input <state.json> [--json]
-                       Create one explicit ignored task-local checkpoint
-  recovery update <session> --input <state.json> --expected-sha256 <sha256> [--json]
-                       CAS-replace one existing task-local checkpoint
-  recovery inspect <session> [--json]
-                       Revalidate Base and derive replay/CAS state
-  recovery preview <session> [--json]
-                       Show the frozen exact writeback patch without writing
-  recovery apply <session> --audit <audit.json> [--json]
-                       CAS-apply and reread only after fresh balanced audit
-  recovery reconcile <session> --audit <audit.json> [--json]
-                       Read-only reconciliation for a no-writeback checkpoint
-  recovery remove <session> --expected-sha256 <sha256> [--json]
-                       Remove only the digest-matched helper-owned checkpoint`);
-}

package/dist/commands/disable.d.ts

@@ -1 +0,0 @@
-export declare function disable(args: string[]): Promise<void>;

package/dist/commands/disable.js

@@ -1,15 +0,0 @@
-import { disableHarnessProfile } from "../lib/profiles.js";
-import { runSync } from "../lib/sync-engine.js";
-export async function disable(args) {
-    const profile = args[0];
-    if (profile !== "long-task" || args.length !== 1) {
-        throw new Error("usage: ty-context disable long-task");
-    }
-    const root = process.cwd();
-    const result = await disableHarnessProfile(root, profile);
-    const sync = await runSync(root);
-    console.log(`${result.changed ? "disabled" : "kept disabled"} profile ${profile}`);
-    console.log(`sync changed=${sync.changed.length} skipped=${sync.skipped.length} blocked=${sync.blocked.length}`);
-    if (sync.blocked.length)
-        throw new Error(sync.blocked.join("\n"));
-}

package/dist/commands/enable.d.ts

@@ -1 +0,0 @@
-export declare function enable(args: string[]): Promise<void>;

package/dist/commands/enable.js

@@ -1,16 +0,0 @@
-import { enableHarnessProfile } from "../lib/profiles.js";
-import { runSync } from "../lib/sync-engine.js";
-export async function enable(args) {
-    const profile = args[0];
-    if (!profile || args.length !== 1)
-        throw new Error("usage: ty-context enable long-task");
-    const root = process.cwd();
-    const result = await enableHarnessProfile(root, profile);
-    const sync = await runSync(root);
-    console.log(`${result.changed ? "enabled" : "kept enabled"} profile ${profile}`);
-    console.log(`sync changed=${sync.changed.length} skipped=${sync.skipped.length} blocked=${sync.blocked.length}`);
-    for (const notice of sync.notices ?? [])
-        console.log(notice);
-    if (sync.blocked.length)
-        throw new Error(sync.blocked.join("\n"));
-}

package/dist/commands/long-task-authoring.d.ts

@@ -1,3 +0,0 @@
-export declare function initializeLongTask(workdir: string): Promise<void>;
-export declare function preflightLongTask(workdir: string): Promise<void>;
-export declare function compactLongTaskTemplate(): string;