project-tiny-context-harness 0.11.0 → 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-authority-delta.d.ts

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

package/dist/commands/design-authority-delta.js

@@ -1,53 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { parseDesignAuthorityDeltaAssessment } from "../lib/design-authority-delta-codec.js";
-import { validateDesignAuthorityDeltaAssessmentCurrent } from "../lib/design-authority-delta-validation.js";
-import { CLI_EXIT_CODES, CliCommandError } from "../lib/cli-exit.js";
-import { normalizeRepositoryFile } from "../lib/long-task-paths.js";
-import { assertProtectedRepositoryFile } from "../lib/repository-path-safety.js";
-import { canonicalJson } from "../lib/strict-codec.js";
-export async function designAuthorityDeltaCommand(args) {
-    const [subcommand = "help", ...rest] = args;
-    if (subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
-        console.log(help());
-        return;
-    }
-    if (subcommand !== "validate")
-        throw new CliCommandError(CLI_EXIT_CODES.arguments, `unknown authority-delta subcommand: ${subcommand}`);
-    const json = rest.includes("--json");
-    const positional = rest.filter((item) => item !== "--json");
-    if (positional.length !== 1)
-        throw new CliCommandError(CLI_EXIT_CODES.arguments, "usage: ty-context design-resource authority-delta validate <assessment.json> [--json]");
-    const repository = process.cwd();
-    const relative = normalizeRepositoryFile(positional[0], "design_authority_delta_assessment");
-    try {
-        const file = await assertProtectedRepositoryFile(repository, path.resolve(repository, ...relative.split("/")), "design_authority_delta_assessment");
-        const assessment = parseDesignAuthorityDeltaAssessment(await readFile(file, "utf8"));
-        const result = await validateDesignAuthorityDeltaAssessmentCurrent(repository, assessment);
-        if (json)
-            process.stdout.write(canonicalJson(result));
-        else {
-            console.log(`Authority Delta Assessment: ${result.assessment}`);
-            console.log(`Authority closure current: ${result.authority_identity.closure_digest}`);
-            console.log("Authority adoption: not performed");
-            console.log("Repository writes: none");
-        }
-    }
-    catch (error) {
-        throw new CliCommandError(CLI_EXIT_CODES.catalog, message(error), {
-            cause: error,
-        });
-    }
-}
-function help() {
-    return `ty-context design-resource authority-delta commands:
-  validate <assessment.json> [--json]
-                       Strictly validate a non-authoritative assessment
-                       against the current complete Design Authority closure
-
-Validation is read-only. It does not select, adopt or update Authority and it
-does not start Design System Authoring.`;
-}
-function message(error) {
-    return error instanceof Error ? error.message : String(error);
-}

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

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

package/dist/commands/design-authority.js

@@ -1,104 +0,0 @@
-import { inspectDesignAuthorityClosure, loadCurrentDesignAuthorityClosure, } from "../lib/design-authority-closure.js";
-import { CLI_EXIT_CODES, CliCommandError } from "../lib/cli-exit.js";
-import { canonicalJson } from "../lib/strict-codec.js";
-import { projectDesignAuthorityTokensFromEntry } from "../lib/design-authority-tokens.js";
-export async function designAuthority(args) {
-    const [subcommand = "help", ...rest] = args;
-    if (subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
-        console.log(help());
-        return;
-    }
-    if (subcommand === "inspect")
-        return inspect(rest);
-    if (subcommand === "tokens")
-        return tokens(rest);
-    throw new CliCommandError(CLI_EXIT_CODES.arguments, `unknown design-authority subcommand: ${subcommand}`);
-}
-async function inspect(args) {
-    const format = parseFormat(args, "inspect");
-    const result = await inspectDesignAuthorityClosure(process.cwd());
-    if (format === "json")
-        process.stdout.write(canonicalJson(result));
-    else
-        process.stdout.write(renderInspection(result));
-    if (result.status !== "valid")
-        process.exitCode = CLI_EXIT_CODES.catalog;
-}
-async function tokens(args) {
-    const fromEntry = args.length === 1 && args[0] === "--from-entry";
-    if (args.length && !fromEntry)
-        throw new CliCommandError(CLI_EXIT_CODES.arguments, "design-authority tokens accepts only --from-entry");
-    let projected = null;
-    try {
-        if (fromEntry) {
-            const result = await projectDesignAuthorityTokensFromEntry(process.cwd());
-            if (!result.success)
-                throw new Error(`DESIGN.md is not locally exportable: ${result.error}`);
-            projected = result.content;
-        }
-        else {
-            const closure = await loadCurrentDesignAuthorityClosure(process.cwd());
-            projected = closure.generated_tokens;
-        }
-    }
-    catch (error) {
-        throw new CliCommandError(CLI_EXIT_CODES.catalog, `cannot project Design Authority Tokens: ${message(error)}`, { cause: error });
-    }
-    if (projected === null)
-        throw new CliCommandError(CLI_EXIT_CODES.catalog, "cannot project Design Authority Tokens: DESIGN.md is not locally exportable");
-    process.stdout.write(projected);
-}
-function parseFormat(args, command) {
-    let format = "text";
-    for (let index = 0; index < args.length; index += 1) {
-        const argument = args[index];
-        if (argument === "--json")
-            format = "json";
-        else if (argument === "--format") {
-            const value = args[index + 1];
-            if (value !== "text" && value !== "json")
-                throw new CliCommandError(CLI_EXIT_CODES.arguments, `design-authority ${command} --format must be text or json`);
-            format = value;
-            index += 1;
-        }
-        else
-            throw new CliCommandError(CLI_EXIT_CODES.arguments, `unknown design-authority ${command} argument: ${argument}`);
-    }
-    return format;
-}
-function renderInspection(result) {
-    const lines = [`Design Authority: ${result.status}`, `Mode: ${result.mode}`];
-    if (result.identity) {
-        lines.push(`Entry: ${result.identity.entry_path}`);
-        lines.push(`Manifest: ${result.identity.manifest_path ?? "none (legacy)"}`);
-        lines.push(`Closure digest: ${result.identity.closure_digest}`);
-        lines.push(`Revision: ${result.identity.revision ?? "not declared"}`);
-        lines.push(`Members: ${result.members.length}`);
-        for (const member of result.members)
-            lines.push(`  - ${member.path} (${member.kind}, ${member.normalized_bytes} bytes)`);
-    }
-    if (result.diagnostics.length) {
-        lines.push("Diagnostics:");
-        for (const diagnostic of result.diagnostics)
-            lines.push(`  - ${diagnostic.severity} ${diagnostic.code}${diagnostic.path ? ` [${diagnostic.path}]` : ""}: ${diagnostic.detail}`);
-    }
-    else
-        lines.push("Diagnostics: none");
-    lines.push("Authority adoption: not performed");
-    return `${lines.join("\n")}\n`;
-}
-function help() {
-    return `ty-context design-authority commands:
-  design-authority inspect [--format text|json]
-                       Validate and explain the current complete closure
-  design-authority tokens [--from-entry]
-                       Print the deterministic DTCG projection from DESIGN.md;
-                       --from-entry permits read-only projection while a bundle
-                       is being revised and its old digest is intentionally stale
-
-Both commands are read-only. They never create a manifest, update a digest,
-select a design direction or adopt a Design Authority revision.`;
-}
-function message(error) {
-    return error instanceof Error ? error.message : String(error);
-}

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>;