frontend-harness 0.1.0

package/dist/runtime/builtin-skills.js

@@ -0,0 +1,269 @@
+export const builtinProjectSkills = [
+    {
+        name: "frontend-discovery",
+        fileName: "frontend-discovery.md",
+        content: `---
+name: frontend-discovery
+title: Frontend Discovery
+description: Use this project skill before non-trivial frontend work to identify local stack, conventions, source-of-truth files, and validation commands.
+triggers: [discovery, inspect, convention, stack, project profile, 探查, 项目结构, 约定, 技术栈]
+intents: [frontend_discovery]
+examples: [discover project conventions before implementing order page, 先梳理前端项目约定]
+---
+# Frontend Discovery
+
+Use this project skill before non-trivial frontend work to produce repository facts, not guesses.
+
+- Identify the app/package boundary, package manager, framework mode, language, UI library, styling system, aliases, env naming, and validation scripts.
+- Locate routing, menu, permission, request, state, form, table, dialog, and testing conventions from source files.
+- Prefer the closest implemented feature pattern over generic frontend or Vue advice.
+- Classify evidence as direct, inferred, absent, or unknown; pass unresolved unknowns into planning instead of filling gaps silently.
+- Treat package scripts as candidates and verify exact command names before relying on them.
+- Do not install dependencies, change files, or pick patterns from another app/package without noting the boundary.
+`
+    },
+    {
+        name: "architecture-boundary",
+        fileName: "architecture-boundary.md",
+        content: `---
+name: architecture-boundary
+title: Architecture Boundary
+description: Use this project skill to decide frontend file placement and ownership across pages, components, composables, stores, API modules, routes, menus, and permissions.
+triggers: [architecture, boundary, placement, layer, route, permission, menu, store, composable, 架构, 边界, 路由, 权限, 菜单]
+intents: [architecture_boundary]
+examples: [decide page component API store boundaries, 规划页面组件接口和权限边界]
+---
+# Architecture Boundary
+
+Use this project skill after discovery and before editing files. Its output is a placement and ownership plan.
+
+- Classify each change as page orchestration, presentational component, feature component, composable, store, API/service module, route/menu permission, utility, or validation-only.
+- Keep route/view files thin: bind route params, compose sections, call feature composables, and delegate display.
+- Keep API transport in the existing request/API layer; do not call raw fetch or axios from components unless the project already does.
+- Use local refs/computed for local state, composables for reusable or side-effect-heavy feature state, and stores only for cross-page or identity/tenant-scoped state.
+- Put display-only UI behind explicit props, emits, slots, and optional v-model contracts.
+- Plan route, menu, breadcrumb, title, keep-alive, permission, and action visibility together when navigation or access changes.
+- Explicitly list what is not being changed to avoid unrelated architecture churn.
+`
+    },
+    {
+        name: "ui-implementation",
+        fileName: "ui-implementation.md",
+        content: `---
+name: ui-implementation
+title: UI Implementation
+description: Use this project skill when implementing frontend UI, adapting generated HTML, or converting design output into project code.
+triggers: [ui, design, stitch, figma, html, component, page, dashboard, table, dialog, drawer, 界面, 页面, 组件, 设计稿, 视觉稿, 表格, 弹窗]
+intents: [ui_implementation]
+examples: [adapt Stitch HTML into order detail page, implement order list page, 实现订单列表页面, 根据设计稿还原页面]
+---
+# UI Implementation
+
+Use this project skill when implementing frontend UI, adapting generated HTML, or converting design output into project code.
+
+- Run discovery and boundary planning for non-trivial UI changes before editing.
+- Treat MCP, Stitch, Figma, or exported HTML as reference material, not production-ready source.
+- Preserve the target project's component API, naming, routing, state, style, UI-library, icon, and layout conventions.
+- Start from the closest existing page or component pattern; only introduce a new pattern when no local pattern exists.
+- Split substantial pages into clear sections such as toolbar/filter, table/list, detail header, form panel, dialog/drawer, and footer actions.
+- Keep derived display state in computed values or helpers; avoid complex inline template expressions.
+- Cover user-visible states: first load, refreshing, empty, error, success, disabled, permission-limited, and responsive behavior when applicable.
+- Prefer semantic HTML and UI-library accessibility behavior before adding ARIA; ensure icon-only controls have accessible names.
+- Verify with project commands and, when interactions changed, a behavior smoke through tests, browser automation, or documented manual checks.
+`
+    },
+    {
+        name: "api-integration",
+        fileName: "api-integration.md",
+        content: `---
+name: api-integration
+title: API Integration
+description: Use this project skill when wiring frontend features to backend APIs or Swagger/OpenAPI contracts.
+triggers: [api, swagger, openapi, endpoint, request, response, dto, pagination, search, mutation, 接口, 对接, 请求, 后端, 数据, 分页, 查询]
+intents: [api_integration]
+examples: [connect order list page to Swagger API endpoint, 根据 swagger 文档进行订单接口对接, 同步订单接口数据]
+---
+# API Integration
+
+Use this project skill when a feature touches backend or mocked server data.
+
+- Discover the existing request client, API module layout, DTO naming, error handling, interceptors, mock strategy, cache/query pattern, cancellation, and pagination shape.
+- Identify the source of truth for every endpoint, method, request field, response field, pagination wrapper, error shape, permission code, and action code.
+- Acceptable evidence includes backend docs, OpenAPI/schema files, generated clients, TypeScript types, network fixtures, MSW/mock handlers, captured examples, or nearby implemented features.
+- Do not invent endpoint paths, fields, enum values, pagination totals, permission codes, or error codes; record unknowns as blockers or assumptions.
+- Keep backend DTO, UI model, form model, and request body boundaries explicit; map DTOs only when the project pattern or UI shape requires it.
+- Preserve invalidation, refetch, cache key, cancellation, stale data, optimistic update, and retry conventions.
+- Handle loading, refreshing, empty, error, retry, search, reset, pagination, submit, delete, and disabled/pending states as applicable.
+- Validate data mapping, request payloads/params, error behavior, and user-visible state transitions with the project test/build tools or a documented smoke path.
+`
+    },
+    {
+        name: "form-workflow",
+        fileName: "form-workflow.md",
+        content: `---
+name: form-workflow
+title: Form Workflow
+description: Use this project skill for create/edit/detail forms, modal or drawer forms, validation, field linkage, async options, uploads, submit locking, and reset behavior.
+triggers: [form, create form, edit form, validation, modal form, drawer form, upload, submit, 表单, 新增, 编辑, 校验, 上传, 提交]
+intents: [form_workflow]
+examples: [build create edit order form, 新增编辑表单, 修复弹窗表单回显]
+---
+# Form Workflow
+
+Use this project skill for forms because defects often come from lifecycle, validation, and submit edges.
+
+- Identify the mode: create, edit, copy, detail-readonly, step form, inline edit, dialog, or drawer.
+- Locate the project's form library and local conventions for schema/rules, refs, model shape, option loading, upload, validation, and submit feedback.
+- Define form model defaults and normalization; keep backend DTO, form model, and UI-only fields separate when they differ.
+- Load edit/detail data before applying validation that depends on remote values.
+- Implement field linkage with clear computed values or watchers; avoid circular updates and stale option state.
+- Implement submit lifecycle: validate, lock, transform, call API, handle success/error, unlock, refetch/close/navigate, and show feedback through local conventions.
+- Reset stale form state on close, route change, record switch, or mode switch.
+- Do not allow double submit, stale edit data, or generic-only server validation errors when field-level errors are supported.
+`
+    },
+    {
+        name: "prd-knowledge",
+        fileName: "prd-knowledge.md",
+        content: `---
+name: prd-knowledge
+title: PRD Knowledge
+description: Use this project skill when turning product requirements into durable project knowledge.
+triggers: [prd, product requirement, requirement document, acceptance criteria, knowledge, 产品需求, 需求文档, 验收标准, 知识库, 沉淀]
+intents: [prd_knowledge]
+examples: [digest PRD into project knowledge, 根据产品需求沉淀知识库]
+---
+# PRD Knowledge
+
+Use this project skill when turning requirements into durable project knowledge.
+
+- Extract domain terms, workflows, roles, permissions, business states, edge cases, data states, and acceptance criteria.
+- Separate direct requirement evidence from implementation assumptions and unresolved product unknowns.
+- Promote stable conclusions into .frontend-harness/knowledge instead of relying only on chat history.
+- Keep knowledge concise, source-aware, scoped, and useful for future UI implementation, API mapping, tests, bug fixes, and requirement changes.
+- Update or deprecate existing knowledge when a PRD changes instead of creating conflicting duplicate notes.
+- Record unknowns as blockers or assumptions when they affect behavior, permission, API shape, validation, or user-visible copy.
+`
+    },
+    {
+        name: "frontend-test",
+        fileName: "frontend-test.md",
+        content: `---
+name: frontend-test
+title: Frontend Test
+description: Use this project skill when adding, updating, or reviewing frontend integration and E2E coverage.
+triggers: [test, e2e, integration test, vitest, playwright, msw, testing library, smoke, 测试, 端到端, 集成测试, 用例, 回归测试]
+intents: [frontend_test]
+examples: [add order flow e2e test, 补充订单流程端到端测试]
+---
+# Frontend Test
+
+Use this project skill when adding, updating, or reviewing frontend behavior coverage.
+
+- Prefer behavior-level assertions over implementation details, private methods, or snapshot-only checks.
+- Start from the project's existing test harness, render helpers, providers, fixtures, router, store, i18n, auth, query, teleport, and mock conventions.
+- Cover the changed workflow, loading/empty/error/success states, validation errors, permissions, route/query changes, request payloads, and regression risks.
+- Mock network at the project-standard boundary, preferably HTTP/MSW when already established; do not mock both API client and HTTP for the same behavior.
+- Drive behavior like a user through role, label, text, keyboard, route navigation, submit/delete/confirm, pagination, search, and reset flows.
+- Reset mocks, stores, router, timers, and shared fixtures to avoid flaky cross-test state.
+- Keep Playwright thin and high-value for browser-only or critical journeys; do not duplicate every integration test in E2E.
+- Record coverage gaps explicitly when infrastructure is absent instead of adding a new test stack without local agreement.
+`
+    },
+    {
+        name: "bug-fix",
+        fileName: "bug-fix.md",
+        content: `---
+name: bug-fix
+title: Bug Fix
+description: Use this project skill when diagnosing and fixing frontend defects.
+triggers: [bug, fix, error, regression, failure, async race, stale state, 修复, 错误, 报错, 缺陷, 回归, 异常]
+intents: [bug_fix]
+examples: [fix login redirect bug, 修复登录跳转错误, 需求变更导致登录报错]
+---
+# Bug Fix
+
+Use this project skill when diagnosing and fixing frontend defects.
+
+- Reproduce or localize the failure before editing when evidence is available.
+- Compare the failing path with the closest working local pattern and intended product knowledge.
+- Check high-risk causes first: API contract mismatch, route/permission wiring, form lifecycle, stale state, async race, error swallowing, component boundary leakage, and validation gaps.
+- Prefer the smallest fix that restores intended project behavior; avoid unrelated refactors or style churn.
+- Add or adjust regression coverage when the failure path is important and testable.
+- Update project knowledge when the bug reveals a durable rule, edge case, product constraint, or known pitfall.
+- If validation cannot run, record the exact blocker and residual risk.
+`
+    },
+    {
+        name: "requirement-change",
+        fileName: "requirement-change.md",
+        content: `---
+name: requirement-change
+title: Requirement Change
+description: Use this project skill when a product requirement changes after implementation has started or shipped.
+triggers: [change, changed requirement, requirement change, sync requirement, acceptance change, 需求变更, 变更, 同步修改, 调整需求]
+intents: [requirement_change]
+examples: [sync changed approval requirement into page and tests, 需求变更后同步修改知识库和页面]
+---
+# Requirement Change
+
+Use this project skill when a product requirement changes after implementation has started or shipped.
+
+- Identify affected knowledge, UI, API mapping, tests, routes, permissions, state, analytics, documentation, and user-visible copy.
+- Update .frontend-harness/knowledge before or alongside code when the change affects durable project understanding.
+- Mark old assumptions as deprecated or replaced so future agents do not reuse stale behavior.
+- Remove obsolete behavior instead of layering conflicting branches or hidden compatibility paths.
+- Re-check architecture boundaries because a requirement change can move ownership between page, component, API, store, permission, or route layers.
+- Verify both the new acceptance criteria and the most likely regression paths from the previous requirement.
+`
+    },
+    {
+        name: "frontend-change-review",
+        fileName: "frontend-change-review.md",
+        content: `---
+name: frontend-change-review
+title: Frontend Change Review
+description: Use this project skill before handoff to review frontend diffs for architecture, API contracts, components, forms, routing, state, validation evidence, and unrelated churn.
+triggers: [review, code review, frontend review, handoff, validation evidence, 评审, 代码审查, 复核, 交付]
+intents: [frontend_review]
+examples: [review frontend changes before handoff, 交付前复核前端改动]
+---
+# Frontend Change Review
+
+Use this project skill as the final gate before handoff or as the primary mode when the user asks for review.
+
+- Inspect the diff and changed files, then identify intended behavior from the user request and local project patterns.
+- Review highest-risk areas first: API fields/contracts, route/permission access, form submit lifecycle, state ownership, async error handling, component boundaries, and unrelated refactors.
+- Check whether implementation followed discovery facts and the placement plan.
+- Check validation evidence: commands run, interaction flows checked, failed command logs, browser/manual checks, and unverified risks.
+- Findings should lead, ordered by severity, with file and line references; if no findings, state that directly with residual risks.
+- Do not approve code that bypasses request layers, permission systems, or project conventions without explicit justification.
+- Do not request broad rewrites when a targeted fix resolves the risk.
+`
+    },
+    {
+        name: "git-commit",
+        fileName: "git-commit.md",
+        content: `---
+name: git-commit
+title: Git Commit
+description: Use this project skill when committing completed agent work.
+triggers: [git, commit, stage, staging, 提交, 暂存, 版本提交]
+intents: [version_control]
+examples: [commit verified plan stage fixes to git, 提交当前关键节点]
+---
+# Git Commit
+
+Use this project skill when committing completed agent work.
+
+- Commit at meaningful checkpoints after the relevant harness verification has passed.
+- Inspect the repository commit protocol before writing the commit message; project AGENTS.md or CLAUDE.md may define the required format.
+- Use commit header format: \`<type>(<scope>): <short description>\`.
+- Allowed types: \`feat\`, \`fix\`, \`docs\`, \`style\`, \`refactor\`, \`perf\`, \`test\`, \`chore\`.
+- Keep the header concise, and add the repository's required trailers such as \`Constraint:\`, \`Rejected:\`, \`Confidence:\`, \`Scope-risk:\`, \`Directive:\`, \`Tested:\`, and \`Not-tested:\` when applicable.
+- Stage only files that belong to the completed task, and do not include unrelated user changes.
+- Mention the verification evidence in the commit message when the project commit protocol provides a place for it.
+`
+    }
+];
+//# sourceMappingURL=builtin-skills.js.map

package/dist/runtime/builtin-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-skills.js","sourceRoot":"","sources":["../../src/runtime/builtin-skills.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAkBZ;KACE;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,0BAA0B;QACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBZ;KACE;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;CAoBZ;KACE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;CAoBZ;KACE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAkBZ;KACE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;CAoBZ;KACE;IACD;QACE,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAkBZ;KACE;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,2BAA2B;QACrC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IACD;QACE,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;CACF,CAAC"}

package/dist/runtime/clean.d.ts

@@ -0,0 +1,11 @@
+export interface CleanOptions {
+    dryRun?: boolean;
+    keepLogs?: number;
+}
+export interface CleanResult {
+    status: "passed";
+    dryRun: boolean;
+    removed: string[];
+    kept: string[];
+}
+export declare function cleanRuntimeArtifacts(projectRoot: string, options?: CleanOptions): CleanResult;

package/dist/runtime/clean.js

@@ -0,0 +1,85 @@
+import fs from "node:fs";
+import path from "node:path";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+const GENERATED_ARTIFACTS = [
+    ["state.json"],
+    ["context"],
+    ["plans"],
+    ["guidance"],
+    ["verification"],
+    ["repair"],
+    ["repair-decision"],
+    ["state-explain"],
+    ["component-graph"],
+    ["execution-units"],
+    ["agent-run"],
+    ["agent-handoff"]
+];
+const DURABLE_ARTIFACTS = [
+    relativeHarnessPath(".gitkeep"),
+    relativeHarnessPath("config.json"),
+    relativeHarnessPath("protocol"),
+    relativeHarnessPath("knowledge"),
+    relativeHarnessPath("skills")
+];
+export function cleanRuntimeArtifacts(projectRoot, options = {}) {
+    const dryRun = Boolean(options.dryRun);
+    const keepLogs = normalizeKeepLogs(options.keepLogs);
+    const removed = [];
+    const kept = [...DURABLE_ARTIFACTS];
+    for (const segments of GENERATED_ARTIFACTS) {
+        const fullPath = harnessPath(projectRoot, ...segments);
+        if (!fs.existsSync(fullPath)) {
+            continue;
+        }
+        const relativePath = relativeHarnessPath(...segments);
+        removed.push(relativePath);
+        if (!dryRun) {
+            fs.rmSync(fullPath, { recursive: true, force: true });
+        }
+    }
+    removed.push(...cleanLogs(projectRoot, keepLogs, dryRun));
+    return {
+        status: "passed",
+        dryRun,
+        removed: removed.sort(),
+        kept
+    };
+}
+function cleanLogs(projectRoot, keepLogs, dryRun) {
+    const logsRoot = harnessPath(projectRoot, "logs");
+    if (!fs.existsSync(logsRoot)) {
+        return [];
+    }
+    const entries = fs.readdirSync(logsRoot, { withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => {
+        const fullPath = path.join(logsRoot, entry.name);
+        return {
+            fullPath,
+            relativePath: relativeHarnessPath("logs", entry.name),
+            mtimeMs: fs.statSync(fullPath).mtimeMs
+        };
+    })
+        .sort((a, b) => b.mtimeMs - a.mtimeMs);
+    const stale = entries.slice(keepLogs);
+    for (const entry of stale) {
+        if (!dryRun) {
+            fs.rmSync(entry.fullPath, { force: true });
+        }
+    }
+    if (!dryRun && fs.existsSync(logsRoot) && fs.readdirSync(logsRoot).length === 0) {
+        fs.rmdirSync(logsRoot);
+    }
+    return stale.map((entry) => entry.relativePath);
+}
+function normalizeKeepLogs(value) {
+    if (value === undefined) {
+        return 20;
+    }
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error("--keep-logs must be a non-negative integer");
+    }
+    return value;
+}
+//# sourceMappingURL=clean.js.map

package/dist/runtime/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/runtime/clean.ts"],"names":[],"mappings":"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"}

package/dist/runtime/command-taxonomy.d.ts

@@ -0,0 +1,12 @@
+export interface HarnessCommand {
+    command: string;
+    description?: string;
+}
+export declare const PUBLIC_HUMAN_COMMANDS: HarnessCommand[];
+export declare const PUBLIC_AGENT_POLICY_COMMANDS: HarnessCommand[];
+export declare const PUBLIC_ADVISORY_COMMANDS: HarnessCommand[];
+export declare const INTERNAL_CHECK_COMMANDS: HarnessCommand[];
+export declare function publicRecommendedCommands(): string[];
+export declare function publicHelpLines(): string[];
+export declare function protocolUsefulCommandLines(): string[];
+export declare function isPublicCommand(command: string): boolean;

package/dist/runtime/command-taxonomy.js

@@ -0,0 +1,72 @@
+export const PUBLIC_HUMAN_COMMANDS = [
+    { command: "frontend-harness init" },
+    { command: "frontend-harness init --json" },
+    { command: "frontend-harness init --dry-run --json" },
+    { command: "frontend-harness init --check --json" },
+    { command: "frontend-harness protocol check" },
+    { command: "frontend-harness protocol check --json" },
+    { command: "frontend-harness clean --json" },
+    { command: "frontend-harness clean --dry-run --json" },
+    { command: "frontend-harness help" },
+    { command: "frontend-harness --help" },
+    { command: "frontend-harness -h" }
+];
+export const PUBLIC_AGENT_POLICY_COMMANDS = [
+    { command: "frontend-harness context --json" },
+    { command: "frontend-harness plan --json \"<task>\"" },
+    { command: "frontend-harness state record-change <file>" },
+    { command: "frontend-harness state record-change --from-git" },
+    { command: "frontend-harness verify --json" },
+    { command: "frontend-harness repair packet --json" },
+    { command: "frontend-harness state next --json" },
+    { command: "frontend-harness state explain --json" }
+];
+export const PUBLIC_ADVISORY_COMMANDS = [
+    { command: "frontend-harness skills list --json" },
+    { command: "frontend-harness skills check --json" },
+    { command: "frontend-harness knowledge promote --json --title \"<title>\" --body \"<body>\"" },
+    { command: "frontend-harness knowledge check --json" }
+];
+export const INTERNAL_CHECK_COMMANDS = [
+    { command: "frontend-harness decision check --json --file <agent-decision.json>" },
+    { command: "frontend-harness units check --json" },
+    { command: "frontend-harness graph check --json" },
+    { command: "frontend-harness repair decision check --json --file <repair-decision.json>" }
+];
+export function publicRecommendedCommands() {
+    return [
+        ...PUBLIC_AGENT_POLICY_COMMANDS,
+        ...PUBLIC_HUMAN_COMMANDS.filter((item) => item.command.includes("init") || item.command.includes("protocol check")),
+        ...PUBLIC_ADVISORY_COMMANDS
+    ].map((item) => item.command);
+}
+export function publicHelpLines() {
+    return [
+        "Human setup and health:",
+        ...PUBLIC_HUMAN_COMMANDS.map((item) => `  ${stripBinaryName(item.command)}`),
+        "",
+        "Agent policy loop:",
+        ...PUBLIC_AGENT_POLICY_COMMANDS.map((item) => `  ${stripBinaryName(item.command)}`),
+        "",
+        "Project advisory/provenance:",
+        ...PUBLIC_ADVISORY_COMMANDS.map((item) => `  ${stripBinaryName(item.command)}`)
+    ];
+}
+export function protocolUsefulCommandLines() {
+    return [
+        ...PUBLIC_AGENT_POLICY_COMMANDS,
+        ...PUBLIC_ADVISORY_COMMANDS,
+        ...INTERNAL_CHECK_COMMANDS
+    ].map((item) => `- \`${item.command}\``);
+}
+export function isPublicCommand(command) {
+    return [
+        ...PUBLIC_HUMAN_COMMANDS,
+        ...PUBLIC_AGENT_POLICY_COMMANDS,
+        ...PUBLIC_ADVISORY_COMMANDS
+    ].some((item) => item.command === command);
+}
+function stripBinaryName(command) {
+    return command.replace(/^frontend-harness\s*/, "");
+}
+//# sourceMappingURL=command-taxonomy.js.map

package/dist/runtime/command-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-taxonomy.js","sourceRoot":"","sources":["../../src/runtime/command-taxonomy.ts"],"names":[],"mappings":"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"}

package/dist/runtime/context.d.ts

@@ -0,0 +1,71 @@
+import type { VerificationCommandDiscovery } from "./verification-commands.js";
+import { type ProjectSurface } from "./project-discovery.js";
+import { type ProjectSkill } from "./skills.js";
+import { type KnowledgeCard } from "./knowledge.js";
+import { type GraphCheckResult } from "./graph.js";
+import { type UnitCheckResult } from "./units.js";
+import { type ProtocolCheckResult } from "./protocol-init.js";
+import type { HarnessState, PlanningDecisionSummary, PolicyProvenance, RepairDecisionSummary } from "../schemas/types.js";
+type ArtifactKey = "latestContext" | "latestPlan" | "latestExecutionUnits" | "latestComponentGraph" | "latestConfig" | "latestVerification" | "latestStateExplain" | "latestRepairPacket" | "latestRepairDecision" | "latestProtocol";
+export interface ProjectContext {
+    projectRoot: string;
+    detectedStack: {
+        packageManager: string;
+        framework: string;
+        language: string;
+    };
+    constraints: string[];
+    knownArtifacts: {
+        latestContext: string;
+        latestPlan: string;
+        latestExecutionUnits: string;
+        latestComponentGraph: string;
+        latestConfig: string;
+        latestVerification: string;
+        latestStateExplain: string;
+        latestRepairPacket: string;
+        latestRepairDecision: string;
+        latestProtocol: string;
+    };
+    projectSurface: ProjectSurface;
+    projectStatus: {
+        artifacts: Record<ArtifactKey, {
+            path: string;
+            exists: boolean;
+            updatedAt: string | null;
+            sha256: string | null;
+        }>;
+        surface: ProjectSurface;
+        verificationCommands: VerificationCommandDiscovery[];
+        knowledge: ProjectKnowledgeSummary[];
+        skills: ProjectSkill[];
+        executionUnits: UnitCheckResult;
+        componentGraph: GraphCheckResult;
+        protocol: ProtocolCheckResult;
+        stateSummary: {
+            status: HarnessState["status"];
+            verificationStatus: HarnessState["verification"]["status"];
+            hasTask: boolean;
+            taskScope: string | null;
+            changedFilesCount: number;
+            retryCount: number;
+            blockerCount: number;
+        };
+        planReadiness: {
+            status: "ready" | "warning" | "blocked";
+            protocolReady: boolean;
+            skillsAvailable: boolean;
+            knowledgeAvailable: boolean;
+            verificationConfigured: boolean;
+            surfaceDetected: boolean;
+            warnings: string[];
+        };
+        planningDecision: PlanningDecisionSummary | null;
+        repairDecision: RepairDecisionSummary | null;
+    };
+    lastPlannedPolicyProvenance: PolicyProvenance;
+    recommendedNextCommands: string[];
+}
+type ProjectKnowledgeSummary = Omit<KnowledgeCard, "searchable">;
+export declare function buildContext(projectRoot: string): ProjectContext;
+export {};