@felixdotgo/aidlc-kit 0.1.1 → 0.2.0

package/dist/src/state/shared.js

@@ -1,71 +0,0 @@
-import { createHash } from "node:crypto";
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { dirname, isAbsolute, join, normalize, resolve } from "node:path";
-import { resolveProjectPathWithoutSymlinks } from "../project-path.js";
-export const statePath = (root) => join(resolve(root), ".agents/data/state/aidlc-state.json");
-export const lessonIndexPath = (root) => join(resolve(root), ".agents/data/lessons/index.json");
-export const memoryRegistryPath = (root) => join(resolve(root), ".agents/data/memory/agentic-memory.json");
-export const stateLockPath = (root) => join(resolve(root), ".agents/data/state/.aidlc-state.lock");
-export const stateLockGuardPath = (root) => join(resolve(root), ".agents/data/state/.aidlc-state.lock.guard");
-export const emptyState = () => ({ schemaVersion: 4, tasks: {}, archive: {} });
-export const legacyG2WaitSource = "schema-v4-migration";
-export const phases = ["clarify", "plan", "build", "wrap", "done"];
-export const gates = ["none", "G0_confirm", "G1_review", "G2_codereview"];
-export const handoffKinds = ["repair_exhausted", "review_exhausted", "g2_failed", "release_failed", "structural_change", "other"];
-export const terminal = (task) => task.status === "done" || task.status === "closed" || task.status === "superseded";
-export const phaseGate = (phase) => phase === "clarify" ? "G0_confirm" : phase === "plan" ? "G1_review" : phase === "build" ? "G2_codereview" : "none";
-export const iso = (value) => typeof value === "string" && Number.isFinite(Date.parse(value)) && new Date(Date.parse(value)).toISOString() === value;
-export const text = (value) => typeof value === "string" && Boolean(value.trim());
-export const idPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
-export const digest = (content) => createHash("sha256").update(content).digest("hex");
-export const archiveRecordPath = (id) => `.agents/data/state/archive/${id}.json`;
-export const taskRecordContent = (task) => `${JSON.stringify(task, null, 2)}\n`;
-export const assertNoSymlinkPath = (root, relative) => {
-    resolveProjectPathWithoutSymlinks(root, relative, "Unsafe state path", "State path crosses a symlink");
-};
-export const writeAtomic = (path, content) => {
-    mkdirSync(dirname(path), { recursive: true });
-    const temporary = `${path}.tmp-${process.pid}-${Date.now()}`;
-    writeFileSync(temporary, content, "utf8");
-    renameSync(temporary, path);
-};
-export const parseJsonText = (content, label, recovery = "") => {
-    try {
-        return JSON.parse(content);
-    }
-    catch (error) {
-        throw new Error(`${label} is corrupted or unreadable: ${error instanceof Error ? error.message : String(error)}${recovery ? `; ${recovery}` : ""}`);
-    }
-};
-export const parseJsonFile = (path, label, recovery = "") => parseJsonText(readFileSync(path, "utf8"), label, recovery);
-export const audited = (reason, source) => {
-    if (!text(reason) || !text(source))
-        throw new Error("Lifecycle mutation requires non-empty --reason and --source");
-};
-export const tokens = (value) => [...new Set(value.toLocaleLowerCase().split(/[^\p{L}\p{N}]+/u).filter((item) => item.length > 1))];
-/** Rejects artifact paths that escape the project-owned tasks directory. */
-export const assertTaskArtifactPath = (id, path) => {
-    const separator = process.platform === "win32" ? "\\" : "/";
-    const cleaned = normalize(path);
-    if (isAbsolute(cleaned) || cleaned === ".." || cleaned.startsWith(`..${separator}`) || !cleaned.startsWith(`.agents${separator}data${separator}tasks${separator}`)) {
-        throw new Error(`Invalid artifact path for ${id}: ${path}`);
-    }
-};
-/** Builds the immutable archive-catalog summary for a terminal task from its record content. */
-export const archivedSummary = (task, content = taskRecordContent(task)) => ({
-    id: task.id,
-    title: task.title,
-    type: task.type,
-    phase: task.phase,
-    gate: task.gate,
-    status: task.status,
-    risk: task.risk,
-    areas: task.areas,
-    record: archiveRecordPath(task.id),
-    digest: digest(content),
-    lessonCount: task.lessons?.length ?? 0,
-    predecessorTaskId: task.predecessorTaskId,
-    successorTaskId: task.successorTaskId,
-    createdAt: task.createdAt,
-    updatedAt: task.updatedAt
-});

package/dist/src/tracker.d.ts

@@ -1,36 +0,0 @@
-/**
- * Backlog tracker integration: resolves tracker credentials from the environment
- * and builds the HTTP requests used to mirror lifecycle phase transitions.
- */
-import type { TrackerConfig } from "./model.js";
-export interface TrackerDiagnostic {
-    code: "TRACKER_DISABLED" | "TRACKER_AUTH" | "TRACKER_RATE_LIMIT" | "TRACKER_REQUEST";
-    message: string;
-    retryable: boolean;
-}
-export interface BacklogRequest {
-    method: "GET" | "PATCH";
-    path: string;
-    form?: Record<string, string | number>;
-}
-export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
-export type TrackerResolution = {
-    enabled: false;
-    diagnostic: TrackerDiagnostic;
-} | {
-    enabled: true;
-    config: TrackerConfig;
-    token: string;
-};
-/** Resolves a tracker configuration into either an enabled resolution (with token) or a disabled diagnostic. */
-export declare const resolveTracker: (config: TrackerConfig | undefined, environment?: NodeJS.ProcessEnv) => TrackerResolution;
-/** Executes a single Backlog request, mapping HTTP failures to retryable diagnostics. */
-export declare const executeBacklog: (resolution: TrackerResolution, request: BacklogRequest, fetcher?: FetchLike) => Promise<{
-    ok: true;
-    body: unknown;
-} | {
-    ok: false;
-    diagnostic: TrackerDiagnostic;
-}>;
-/** Builds the Backlog PATCH request that mirrors a lifecycle phase transition for an issue. */
-export declare const gateUpdate: (config: TrackerConfig, issue: string, phase: "clarify" | "plan" | "build" | "wrap" | "done", idempotencyKey: string) => BacklogRequest;

package/dist/src/tracker.js

@@ -1,44 +0,0 @@
-/** Resolves a tracker configuration into either an enabled resolution (with token) or a disabled diagnostic. */
-export const resolveTracker = (config, environment = process.env) => {
-    if (!config)
-        return { enabled: false, diagnostic: { code: "TRACKER_DISABLED", message: "Tracker is not configured; Git-only mode is active.", retryable: false } };
-    const token = environment[config.tokenEnv];
-    if (!token)
-        return { enabled: false, diagnostic: { code: "TRACKER_DISABLED", message: `Backlog tracker is disabled because ${config.tokenEnv} is unavailable.`, retryable: false } };
-    return { enabled: true, config, token };
-};
-const form = (values) => {
-    const body = new URLSearchParams();
-    for (const [key, value] of Object.entries(values))
-        body.set(key, String(value));
-    return body;
-};
-/** Executes a single Backlog request, mapping HTTP failures to retryable diagnostics. */
-export const executeBacklog = async (resolution, request, fetcher = fetch) => {
-    if (!resolution.enabled)
-        return { ok: false, diagnostic: resolution.diagnostic };
-    const response = await fetcher(`${resolution.config.spaceUrl}/api/v2/${request.path.replace(/^\//, "")}`, {
-        method: request.method,
-        headers: { Authorization: `Bearer ${resolution.token}`, ...(request.form ? { "Content-Type": "application/x-www-form-urlencoded" } : {}) },
-        body: request.form ? form(request.form) : undefined
-    });
-    if (response.status === 401)
-        return { ok: false, diagnostic: { code: "TRACKER_AUTH", message: "Backlog authentication failed; Git state was not changed.", retryable: false } };
-    if (response.status === 429)
-        return { ok: false, diagnostic: { code: "TRACKER_RATE_LIMIT", message: "Backlog rate limit reached; retry after the provider reset window.", retryable: true } };
-    if (!response.ok)
-        return { ok: false, diagnostic: { code: "TRACKER_REQUEST", message: `Backlog request failed with HTTP ${response.status}.`, retryable: response.status >= 500 } };
-    return { ok: true, body: await response.json() };
-};
-/** Builds the Backlog PATCH request that mirrors a lifecycle phase transition for an issue. */
-export const gateUpdate = (config, issue, phase, idempotencyKey) => {
-    const comment = `[aidlc:${idempotencyKey}] ${phase}`;
-    if (config.workflow === "waterfall") {
-        const statusId = config.mapping.statuses?.[phase];
-        if (!statusId)
-            throw new Error(`Backlog status mapping is required for Waterfall phase: ${phase}`);
-        return { method: "PATCH", path: `issues/${issue}`, form: { statusId, comment } };
-    }
-    const field = config.mapping.gateFieldId;
-    return { method: "PATCH", path: `issues/${issue}`, form: { ...(field ? { [`customField_${field}`]: phase } : {}), comment } };
-};