frontend-harness 0.1.0

package/dist/runtime/knowledge.js

@@ -0,0 +1,383 @@
+import fs from "node:fs";
+import path from "node:path";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+import { writeText } from "../storage/json.js";
+const knowledgeTypes = new Set([
+    "prd_semantics",
+    "project_convention",
+    "decision_record",
+    "pitfall",
+    "glossary"
+]);
+const knowledgeStatuses = new Set(["active", "deprecated"]);
+const knowledgeStabilities = new Set(["stable", "evolving"]);
+export function promoteKnowledge(projectRoot, input) {
+    const title = input.title?.trim();
+    const body = input.body?.trim();
+    if (!title) {
+        throw new Error("knowledge promote requires --title");
+    }
+    if (!body) {
+        throw new Error("knowledge promote requires --body");
+    }
+    const type = parseKnowledgeType(input.type ?? "prd_semantics", "knowledge promote --type");
+    const status = parseKnowledgeStatus(input.status ?? "active", "knowledge promote --status");
+    const stability = parseKnowledgeStability(input.stability ?? "stable", "knowledge promote --stability");
+    const createdAt = new Date().toISOString();
+    const id = slugify(title) || `knowledge-${formatKnowledgeStamp(createdAt).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "")}`;
+    const fileName = `${formatKnowledgeStamp(createdAt)}-${id}.md`;
+    const relativePath = relativeHarnessPath("knowledge", fileName);
+    const content = renderKnowledge({
+        id,
+        title,
+        body,
+        type,
+        status,
+        stability,
+        createdAt,
+        scope: splitList(input.scope),
+        sourcePaths: splitList(input.source)
+    });
+    writeText(path.join(projectRoot, relativePath), content);
+    return {
+        path: relativePath,
+        id,
+        title,
+        type,
+        status,
+        stability,
+        createdAt
+    };
+}
+export function discoverKnowledgeCards(projectRoot) {
+    const knowledgeRoot = harnessPath(projectRoot, "knowledge");
+    if (!isReadableDirectory(knowledgeRoot)) {
+        return [];
+    }
+    return listMarkdownFiles(knowledgeRoot)
+        .flatMap((fullPath) => {
+        const card = describeKnowledgeCard(projectRoot, fullPath);
+        return card ? [card] : [];
+    })
+        .sort((left, right) => left.path.localeCompare(right.path));
+}
+export function checkKnowledge(projectRoot) {
+    const knowledgeRoot = harnessPath(projectRoot, "knowledge");
+    const relativeRoot = path.relative(projectRoot, knowledgeRoot).split(path.sep).join(path.posix.sep);
+    if (!fs.existsSync(knowledgeRoot)) {
+        return {
+            status: "not_configured",
+            knowledgeRoot: relativeRoot,
+            cardCount: 0,
+            activeCardCount: 0,
+            deprecatedCardCount: 0,
+            errors: [],
+            warnings: ["Create .frontend-harness/knowledge before checking project knowledge."]
+        };
+    }
+    const errors = [];
+    const warnings = [];
+    if (!isReadableDirectory(knowledgeRoot)) {
+        errors.push(".frontend-harness/knowledge must be a readable directory.");
+    }
+    const files = isReadableDirectory(knowledgeRoot) ? listMarkdownFiles(knowledgeRoot, errors) : [];
+    const ids = new Set();
+    const duplicateIds = new Set();
+    let activeCardCount = 0;
+    let deprecatedCardCount = 0;
+    for (const fullPath of files) {
+        const relativePath = path.relative(projectRoot, fullPath).split(path.sep).join(path.posix.sep);
+        const content = safeRead(fullPath);
+        if (content === null) {
+            errors.push(`${relativePath} cannot be read.`);
+            continue;
+        }
+        const parsed = parseKnowledgeFrontmatter(content);
+        if (!parsed.hasFrontmatter) {
+            errors.push(`${relativePath} must include YAML frontmatter.`);
+            continue;
+        }
+        const cardErrors = validateKnowledgeMetadata(relativePath, parsed.metadata);
+        errors.push(...cardErrors);
+        const id = parsed.metadata.id;
+        if (id) {
+            if (ids.has(id)) {
+                duplicateIds.add(id);
+            }
+            ids.add(id);
+        }
+        if (parsed.metadata.status === "active") {
+            activeCardCount += 1;
+        }
+        if (parsed.metadata.status === "deprecated") {
+            deprecatedCardCount += 1;
+            if (!parsed.metadata.related.length) {
+                warnings.push(`${relativePath} is deprecated without a related replacement or explanation.`);
+            }
+        }
+    }
+    for (const duplicateId of duplicateIds) {
+        errors.push(`Duplicate knowledge id: ${duplicateId}.`);
+    }
+    return {
+        status: errors.length ? "failed" : "passed",
+        knowledgeRoot: relativeRoot,
+        cardCount: files.length,
+        activeCardCount,
+        deprecatedCardCount,
+        errors,
+        warnings
+    };
+}
+function describeKnowledgeCard(projectRoot, fullPath) {
+    const relativePath = path.relative(projectRoot, fullPath).split(path.sep).join(path.posix.sep);
+    const content = safeRead(fullPath);
+    if (content === null) {
+        return null;
+    }
+    const parsed = parseKnowledgeFrontmatter(content);
+    if (!parsed.hasFrontmatter || validateKnowledgeMetadata(relativePath, parsed.metadata).length) {
+        return null;
+    }
+    const metadata = parsed.metadata;
+    const title = metadata.title;
+    const summary = metadata.summary;
+    const type = metadata.type;
+    const status = metadata.status;
+    const stability = metadata.stability;
+    const scope = metadata.scope;
+    const tags = metadata.tags;
+    const sourcePaths = metadata.sourcePaths;
+    const related = metadata.related;
+    const updatedAt = metadata.updatedAt;
+    return {
+        id: metadata.id,
+        path: relativePath,
+        title,
+        summary,
+        type,
+        status,
+        stability,
+        scope,
+        tags,
+        sourcePaths,
+        related,
+        updatedAt,
+        searchable: normalize([
+            relativePath,
+            metadata.id,
+            title,
+            summary,
+            type,
+            stability,
+            ...scope,
+            ...tags,
+            ...sourcePaths,
+            ...related
+        ].join(" "))
+    };
+}
+function parseKnowledgeFrontmatter(content) {
+    const metadata = {
+        scope: [],
+        tags: [],
+        sourcePaths: [],
+        related: []
+    };
+    if (!content.startsWith("---\n")) {
+        return { hasFrontmatter: false, metadata };
+    }
+    const endIndex = content.indexOf("\n---", 4);
+    if (endIndex < 0) {
+        return { hasFrontmatter: false, metadata };
+    }
+    const listKeys = new Set(["scope", "tags", "source_paths", "related"]);
+    let currentList = null;
+    for (const line of content.slice(4, endIndex).split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const listItem = trimmed.match(/^-\s+(.+)$/);
+        if (listItem && currentList) {
+            const value = listItem[1];
+            if (value) {
+                metadata[currentList].push(unquoteScalar(value));
+            }
+            continue;
+        }
+        const pair = trimmed.match(/^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/);
+        if (!pair) {
+            currentList = null;
+            continue;
+        }
+        const key = pair[1] ?? "";
+        const value = (pair[2] ?? "").trim();
+        if (key === "id" || key === "title" || key === "summary" || key === "type" || key === "status" || key === "stability") {
+            metadata[key] = unquoteScalar(value);
+            currentList = null;
+            continue;
+        }
+        if (key === "updated_at") {
+            metadata.updatedAt = unquoteScalar(value);
+            currentList = null;
+            continue;
+        }
+        if (listKeys.has(key)) {
+            const mappedKey = key === "source_paths" ? "sourcePaths" : key;
+            metadata[mappedKey] = parseListValue(value);
+            currentList = value ? null : mappedKey;
+            continue;
+        }
+        currentList = null;
+    }
+    return { hasFrontmatter: true, metadata };
+}
+function validateKnowledgeMetadata(relativePath, metadata) {
+    const errors = [];
+    if (!metadata.id || !/^[a-z0-9][a-z0-9-]{2,80}$/.test(metadata.id)) {
+        errors.push(`${relativePath} must include a kebab-case id.`);
+    }
+    if (!metadata.title) {
+        errors.push(`${relativePath} must include a non-empty title.`);
+    }
+    if (!metadata.summary) {
+        errors.push(`${relativePath} must include a non-empty summary.`);
+    }
+    if (!metadata.type || !knowledgeTypes.has(metadata.type)) {
+        errors.push(`${relativePath} type must be one of: ${[...knowledgeTypes].join(", ")}.`);
+    }
+    if (!metadata.status || !knowledgeStatuses.has(metadata.status)) {
+        errors.push(`${relativePath} status must be one of: ${[...knowledgeStatuses].join(", ")}.`);
+    }
+    if (!metadata.stability || !knowledgeStabilities.has(metadata.stability)) {
+        errors.push(`${relativePath} stability must be one of: ${[...knowledgeStabilities].join(", ")}.`);
+    }
+    if (!metadata.updatedAt || !/^\d{4}-\d{2}-\d{2}([T ][0-9:.+-Z]+)?$/.test(metadata.updatedAt)) {
+        errors.push(`${relativePath} must include updated_at as YYYY-MM-DD or ISO timestamp.`);
+    }
+    return errors;
+}
+function renderKnowledge(input) {
+    const summary = firstBodyLine(input.body) ?? input.title;
+    return `---
+id: ${input.id}
+type: ${input.type}
+title: ${input.title}
+summary: ${summary}
+scope:
+${renderList(input.scope)}
+status: ${input.status}
+stability: ${input.stability}
+updated_at: ${input.createdAt}
+source_paths:
+${renderList(input.sourcePaths)}
+related: []
+---
+
+# ${input.title}
+
+${input.body}
+`;
+}
+function renderList(items) {
+    return items.length ? items.map((item) => `  - ${item}`).join("\n") : "  []";
+}
+function firstBodyLine(body) {
+    return body
+        .split("\n")
+        .map((line) => line.trim())
+        .find((line) => line && !line.startsWith("#") && !line.startsWith("- ")) ?? null;
+}
+function parseKnowledgeType(value, label) {
+    if (knowledgeTypes.has(value)) {
+        return value;
+    }
+    throw new Error(`${label} must be one of: ${[...knowledgeTypes].join(", ")}`);
+}
+function parseKnowledgeStatus(value, label) {
+    if (knowledgeStatuses.has(value)) {
+        return value;
+    }
+    throw new Error(`${label} must be one of: ${[...knowledgeStatuses].join(", ")}`);
+}
+function parseKnowledgeStability(value, label) {
+    if (knowledgeStabilities.has(value)) {
+        return value;
+    }
+    throw new Error(`${label} must be one of: ${[...knowledgeStabilities].join(", ")}`);
+}
+function splitList(value) {
+    return value
+        ? value.split(",").map((item) => item.trim()).filter(Boolean)
+        : [];
+}
+function parseListValue(value) {
+    if (!value || value === "[]") {
+        return [];
+    }
+    const inline = value.match(/^\[(.*)\]$/);
+    if (!inline) {
+        return [unquoteScalar(value)];
+    }
+    return (inline[1] ?? "")
+        .split(",")
+        .map((item) => unquoteScalar(item.trim()))
+        .filter(Boolean);
+}
+function unquoteScalar(value) {
+    return value.replace(/^["']|["']$/g, "").trim();
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+function formatKnowledgeStamp(createdAt) {
+    return createdAt
+        .replace(/[-:]/g, "")
+        .replace(/\.\d{3}Z$/, "Z");
+}
+function safeRead(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function isReadableDirectory(directory) {
+    try {
+        return fs.statSync(directory).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function listMarkdownFiles(directory, errors) {
+    try {
+        return fs.readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+            const fullPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith(".")) {
+                    return [];
+                }
+                return listMarkdownFiles(fullPath, errors);
+            }
+            return entry.name.endsWith(".md") ? [fullPath] : [];
+        });
+    }
+    catch (error) {
+        if (errors) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(`Cannot read .frontend-harness/knowledge: ${message}`);
+        }
+        return [];
+    }
+}
+function normalize(value) {
+    return value.toLowerCase().replace(/[^\p{L}\p{N}-]+/gu, " ").trim();
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/runtime/knowledge.js.map

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

package/dist/runtime/plan.d.ts

@@ -0,0 +1,18 @@
+import type { AgentDecisionCheckResult, ComponentItem, ExecutionGuidanceStep, ExecutionUnit, TaskUnderstanding } from "../schemas/types.js";
+export interface PlanInput {
+    taskText: string;
+    prd?: string;
+    ui?: string;
+    agentDecision?: string;
+}
+export interface PlanOutput {
+    task: TaskUnderstanding;
+    components: ComponentItem[];
+    units: ExecutionUnit[];
+    executionGuidance: ExecutionGuidanceStep[];
+    componentGraphPath: string;
+    guidancePath: string;
+    statePath: string;
+}
+export declare function createPlan(projectRoot: string, input: PlanInput): PlanOutput;
+export declare function checkAgentPlanningDecision(projectRoot: string, file: string | undefined): AgentDecisionCheckResult;