@felixdotgo/aidlc-kit 0.1.1 → 0.3.0

package/dist/src/model/config-contracts.d.ts

@@ -0,0 +1,65 @@
+import type { AgentId, RiskLevel, StateMutationMode } from "./lifecycle-enums.js";
+import type { LoopConfig } from "./loop.js";
+export interface CommandSpec {
+    command: string;
+    args: string[];
+}
+export interface Profile {
+    schemaVersion: 1;
+    id: string;
+    extends?: string[];
+    topology: string;
+    discovery?: {
+        roots?: string[];
+        workspaceMarkers?: string[];
+    };
+    specs?: {
+        roots?: string[];
+    };
+    commands?: Record<string, CommandSpec>;
+    rules?: {
+        include?: string[];
+    };
+}
+export interface ProjectConfig {
+    $schema?: string;
+    schemaVersion: 1 | 2 | 3;
+    extends: string[];
+    specs: {
+        roots: string[];
+    };
+    commands: Record<string, CommandSpec>;
+    rules: {
+        include: string[];
+    };
+    risk: {
+        default: RiskLevel;
+    };
+    context: {
+        maxChars: number;
+    };
+    agentState: Partial<Record<AgentId, StateMutationMode>>;
+    tracker?: TrackerConfig;
+    mcp: McpConfig;
+    loop?: LoopConfig;
+}
+export interface McpConfig {
+    enabled: boolean;
+    endpoint?: string;
+    workspace?: string;
+    tokenEnv?: string;
+    pollMs?: number;
+    providers?: Array<"jira" | "trello" | "github-issues">;
+}
+export interface TrackerConfig {
+    enabled: boolean;
+    provider: "backlog";
+    spaceUrl: string;
+    project: string;
+    tokenEnv: string;
+    workflow: "waterfall" | "scrum";
+    mapping: {
+        statuses?: Partial<Record<"clarify" | "plan" | "build" | "wrap" | "done", number>>;
+        gateFieldId?: number;
+    };
+}

package/dist/src/model/config-contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/src/model/install-contracts.d.ts

@@ -0,0 +1,29 @@
+import type { AgentId } from "./lifecycle-enums.js";
+import type { LoopConfig } from "./loop.js";
+export interface FileSpec {
+    path: string;
+    content: string;
+    owner: string;
+    strategy?: "replace" | "managed-block";
+    ownershipClass?: "managed" | "project" | "state";
+}
+export interface Adapter {
+    id: AgentId;
+    displayName: string;
+    detect(root: string): boolean;
+    files(): FileSpec[];
+}
+export interface PlannedWrite extends FileSpec {
+    action: "create" | "update" | "delete" | "skip" | "conflict" | "migrate" | "preserve";
+    reason: string;
+    contentEncoding?: "base64";
+}
+export interface InitOptions {
+    root: string;
+    agents: AgentId[];
+    all: boolean;
+    dryRun: boolean;
+    yes: boolean;
+    force: boolean;
+    loop?: LoopConfig;
+}

package/dist/src/model/install-contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/src/model/lifecycle-enums.d.ts

@@ -0,0 +1,13 @@
+export type AgentId = string;
+export type StateMutationMode = "native" | "scripted";
+export type Phase = "clarify" | "plan" | "build" | "wrap" | "done";
+export type Gate = "none" | "G0_confirm" | "G1_review" | "G2_codereview";
+export type TaskStatus = "active" | "blocked_on_user" | "paused" | "done" | "closed" | "superseded";
+export type RiskLevel = "low" | "normal" | "high" | "regulated";
+export type DecisionStatus = "unresolved" | "approved" | "changed" | "dropped";
+export type HandoffKind = "repair_exhausted" | "review_exhausted" | "g2_failed" | "release_failed" | "structural_change" | "other";
+export interface Diagnostic {
+    level: "ERROR" | "WARN" | "INFO";
+    code: string;
+    message: string;
+}

package/dist/src/model/lifecycle-enums.js

@@ -0,0 +1 @@
+export {};

package/dist/src/model/loop.d.ts

@@ -0,0 +1,20 @@
+export type LoopMode = "off" | "local" | "fleet";
+export declare const LOOP_PROVIDERS: readonly ["codex", "claude", "opencode"];
+export type LoopAgent = (typeof LOOP_PROVIDERS)[number];
+export interface LoopConfig {
+    mode: LoopMode;
+    agents?: {
+        lead: LoopAgent;
+        workers: Record<string, LoopAgent>;
+    };
+    workerImage?: Partial<Record<LoopAgent, string>>;
+    /** Local daemon canonical-state poll interval (1000–300000 ms). */
+    pollMs?: number;
+    /** Per-run lead loop limits; bounds mirror `validateLimits` in loop-runtime.mjs. */
+    limits?: LoopLimits;
+}
+export interface LoopLimits {
+    maxTurns?: number;
+    turnTimeoutMs?: number;
+    maxStallTurns?: number;
+}

package/dist/src/model/loop.js

@@ -0,0 +1 @@
+export const LOOP_PROVIDERS = Object.freeze(["codex", "claude", "opencode"]);

package/dist/src/model/manifest.d.ts

@@ -0,0 +1,16 @@
+import type { AgentId } from "./lifecycle-enums.js";
+export interface ManifestInventoryItem {
+    hash: string;
+    owner: string;
+    strategy: "replace" | "managed-block";
+}
+export interface WorkflowManifest {
+    schemaVersion: 2;
+    packageVersion: string;
+    workflow: "AI-DLC";
+    source: "local-package-assets";
+    remoteUpdates: false;
+    managedBy: "aidlc-kit" | "aidlc-workflow";
+    adapters: AgentId[];
+    files: Record<string, ManifestInventoryItem>;
+}

package/dist/src/model/manifest.js

@@ -0,0 +1 @@
+export {};

package/dist/src/model/records.d.ts

@@ -0,0 +1,142 @@
+import type { DecisionStatus, Gate, HandoffKind, Phase, RiskLevel, TaskStatus } from "./lifecycle-enums.js";
+export interface TaskDecision {
+    id: string;
+    label: string;
+    status: DecisionStatus;
+    resolution?: string;
+}
+export interface Evidence {
+    kind: "approval" | "spec" | "test" | "lint" | "review" | "diagnostic";
+    gate?: Gate;
+    area?: string;
+    source: string;
+    result: "pass" | "fail" | "skip";
+    detail?: string;
+    recordedAt: string;
+}
+export interface LessonRecord {
+    id: string;
+    taskId: string;
+    areas: string[];
+    summary: string;
+    prevention: string;
+    example: string;
+    promotion: string;
+    source: string;
+    recordedAt: string;
+}
+export interface LessonDisposition {
+    status: "captured" | "none";
+    reason?: string;
+    source: string;
+    recordedAt: string;
+}
+export interface TaskState {
+    id: string;
+    featureId?: string;
+    title: string;
+    type: "feature" | "bug" | "refactor" | "infra";
+    phase: Phase;
+    gate: Gate;
+    status: TaskStatus;
+    language: "vi" | "en";
+    risk: RiskLevel;
+    areas: string[];
+    branch: string;
+    artifacts: {
+        intent?: string;
+        design?: string;
+        workplan?: string;
+    };
+    decisions: TaskDecision[];
+    tasks: Array<{
+        id: string;
+        label: string;
+        status: "todo" | "in_progress" | "done" | "deferred";
+        dependsOn?: string[];
+        ownedPaths?: string[];
+    }>;
+    evidence: Evidence[];
+    lessons?: LessonRecord[];
+    lessonDisposition?: LessonDisposition;
+    handoff?: {
+        kind: HandoffKind;
+        reason: string;
+        source: string;
+        recordedAt: string;
+    };
+    closure?: {
+        reason: string;
+        source: string;
+        recordedAt: string;
+    };
+    legacyG2Wait?: {
+        migratedAt: string;
+        source: string;
+    };
+    predecessorTaskId?: string;
+    successorTaskId?: string;
+    /** Repository HEAD when the task was created (lowercase hex SHA, 7-64 chars). */
+    baseCommit?: string;
+    /** Repository HEAD when the task reached done (lowercase hex SHA, 7-64 chars). */
+    finalCommit?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkflowState {
+    schemaVersion: 1 | 2 | 3 | 4;
+    tasks: Record<string, TaskState>;
+    archive?: Record<string, ArchivedTaskSummary>;
+}
+export interface ArchivedTaskSummary {
+    id: string;
+    title: string;
+    type: TaskState["type"];
+    phase: Phase;
+    gate: Gate;
+    status: "done" | "closed" | "superseded";
+    risk: RiskLevel;
+    areas: string[];
+    record: string;
+    digest: string;
+    lessonCount: number;
+    predecessorTaskId?: string;
+    successorTaskId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LessonIndexEntry {
+    id: string;
+    taskId: string;
+    areas: string[];
+    summary: string;
+    prevention: string;
+    source: string;
+    recordedAt: string;
+}
+export interface LessonIndex {
+    schemaVersion: 1;
+    sourceDigest: string;
+    lessons: LessonIndexEntry[];
+}
+export interface AgenticMemoryEntry {
+    id: string;
+    summary: string;
+    guidance: string;
+    areas: string[];
+    phases: Array<Exclude<Phase, "done"> | "*">;
+    priority: number;
+    sourceTaskId: string;
+    sourceLessonId: string;
+    approvedBy: string;
+    approvedAt: string;
+}
+export interface AgenticMemoryRegistry {
+    schemaVersion: 1;
+    entries: AgenticMemoryEntry[];
+    retired: Array<AgenticMemoryEntry & {
+        retiredBy: string;
+        retiredAt: string;
+        reason: string;
+    }>;
+}

package/dist/src/model/records.js

@@ -0,0 +1 @@
+export {};

package/dist/src/model.d.ts

@@ -1,264 +1,11 @@
-export type AgentId = string;
-export type StateMutationMode = "native" | "scripted";
-export type Phase = "clarify" | "plan" | "build" | "wrap" | "done";
-export type Gate = "none" | "G0_confirm" | "G1_review" | "G2_codereview";
-export type TaskStatus = "active" | "blocked_on_user" | "paused" | "done" | "closed" | "superseded";
-export type RiskLevel = "low" | "normal" | "high" | "regulated";
-export type DecisionStatus = "unresolved" | "approved" | "changed" | "dropped";
-export type HandoffKind = "repair_exhausted" | "review_exhausted" | "g2_failed" | "release_failed" | "structural_change" | "other";
-export interface FileSpec {
-    path: string;
-    content: string;
-    owner: string;
-    strategy?: "replace" | "managed-block";
-    ownershipClass?: "managed" | "project" | "state";
-}
-export interface Adapter {
-    id: AgentId;
-    displayName: string;
-    detect(root: string): boolean;
-    files(): FileSpec[];
-}
-export interface PlannedWrite extends FileSpec {
-    action: "create" | "update" | "delete" | "skip" | "conflict" | "migrate" | "preserve";
-    reason: string;
-    contentEncoding?: "base64";
-}
-export interface InitOptions {
-    root: string;
-    agents: AgentId[];
-    all: boolean;
-    dryRun: boolean;
-    yes: boolean;
-    force: boolean;
-    loop?: LoopConfig;
-}
-export type LoopMode = "off" | "local" | "fleet";
-export declare const LOOP_PROVIDERS: readonly ["codex", "claude", "opencode"];
-export type LoopAgent = (typeof LOOP_PROVIDERS)[number];
-export interface LoopConfig {
-    mode: LoopMode;
-    agents?: {
-        lead: LoopAgent;
-        workers: Record<string, LoopAgent>;
-    };
-}
-export interface CommandSpec {
-    command: string;
-    args: string[];
-}
-export interface Profile {
-    schemaVersion: 1;
-    id: string;
-    extends?: string[];
-    topology: string;
-    discovery?: {
-        roots?: string[];
-        workspaceMarkers?: string[];
-    };
-    specs?: {
-        roots?: string[];
-    };
-    commands?: Record<string, CommandSpec>;
-    rules?: {
-        include?: string[];
-    };
-}
-export interface ProjectConfig {
-    schemaVersion: 1 | 2 | 3;
-    extends: string[];
-    specs: {
-        roots: string[];
-    };
-    commands: Record<string, CommandSpec>;
-    rules: {
-        include: string[];
-    };
-    risk: {
-        default: RiskLevel;
-    };
-    context: {
-        maxChars: number;
-    };
-    agentState: Partial<Record<AgentId, StateMutationMode>>;
-    tracker?: TrackerConfig;
-    mcp: McpConfig;
-    loop?: LoopConfig;
-}
-export interface McpConfig {
-    enabled: boolean;
-    endpoint?: string;
-    workspace?: string;
-    tokenEnv?: string;
-    pollMs?: number;
-    providers?: Array<"jira" | "trello" | "github-issues">;
-}
-export interface TrackerConfig {
-    enabled: boolean;
-    provider: "backlog";
-    spaceUrl: string;
-    project: string;
-    tokenEnv: string;
-    workflow: "waterfall" | "scrum";
-    mapping: {
-        statuses?: Partial<Record<"clarify" | "plan" | "build" | "wrap" | "done", number>>;
-        gateFieldId?: number;
-    };
-}
-export interface TaskDecision {
-    id: string;
-    label: string;
-    status: DecisionStatus;
-    resolution?: string;
-}
-export interface Evidence {
-    kind: "approval" | "spec" | "test" | "lint" | "review" | "diagnostic";
-    gate?: Gate;
-    area?: string;
-    source: string;
-    result: "pass" | "fail" | "skip";
-    detail?: string;
-    recordedAt: string;
-}
-export interface LessonRecord {
-    id: string;
-    taskId: string;
-    areas: string[];
-    summary: string;
-    prevention: string;
-    example: string;
-    promotion: string;
-    source: string;
-    recordedAt: string;
-}
-export interface LessonDisposition {
-    status: "captured" | "none";
-    reason?: string;
-    source: string;
-    recordedAt: string;
-}
-export interface TaskState {
-    id: string;
-    featureId?: string;
-    title: string;
-    type: "feature" | "bug" | "refactor" | "infra";
-    phase: Phase;
-    gate: Gate;
-    status: TaskStatus;
-    language: "vi" | "en";
-    risk: RiskLevel;
-    areas: string[];
-    branch: string;
-    artifacts: {
-        intent?: string;
-        design?: string;
-        workplan?: string;
-    };
-    decisions: TaskDecision[];
-    tasks: Array<{
-        id: string;
-        label: string;
-        status: "todo" | "in_progress" | "done" | "deferred";
-        dependsOn?: string[];
-        ownedPaths?: string[];
-    }>;
-    evidence: Evidence[];
-    lessons?: LessonRecord[];
-    lessonDisposition?: LessonDisposition;
-    handoff?: {
-        kind: HandoffKind;
-        reason: string;
-        source: string;
-        recordedAt: string;
-    };
-    closure?: {
-        reason: string;
-        source: string;
-        recordedAt: string;
-    };
-    legacyG2Wait?: {
-        migratedAt: string;
-        source: string;
-    };
-    predecessorTaskId?: string;
-    successorTaskId?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface WorkflowState {
-    schemaVersion: 1 | 2 | 3 | 4;
-    tasks: Record<string, TaskState>;
-    archive?: Record<string, ArchivedTaskSummary>;
-}
-export interface ArchivedTaskSummary {
-    id: string;
-    title: string;
-    type: TaskState["type"];
-    phase: Phase;
-    gate: Gate;
-    status: "done" | "closed" | "superseded";
-    risk: RiskLevel;
-    areas: string[];
-    record: string;
-    digest: string;
-    lessonCount: number;
-    predecessorTaskId?: string;
-    successorTaskId?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface LessonIndexEntry {
-    id: string;
-    taskId: string;
-    areas: string[];
-    summary: string;
-    prevention: string;
-    source: string;
-    recordedAt: string;
-}
-export interface LessonIndex {
-    schemaVersion: 1;
-    sourceDigest: string;
-    lessons: LessonIndexEntry[];
-}
-export interface AgenticMemoryEntry {
-    id: string;
-    summary: string;
-    guidance: string;
-    areas: string[];
-    phases: Array<Exclude<Phase, "done"> | "*">;
-    priority: number;
-    sourceTaskId: string;
-    sourceLessonId: string;
-    approvedBy: string;
-    approvedAt: string;
-}
-export interface AgenticMemoryRegistry {
-    schemaVersion: 1;
-    entries: AgenticMemoryEntry[];
-    retired: Array<AgenticMemoryEntry & {
-        retiredBy: string;
-        retiredAt: string;
-        reason: string;
-    }>;
-}
-export interface ManifestInventoryItem {
-    hash: string;
-    owner: string;
-    strategy: "replace" | "managed-block";
-}
-export interface WorkflowManifest {
-    schemaVersion: 2;
-    packageVersion: string;
-    workflow: "AI-DLC";
-    source: "local-package-assets";
-    remoteUpdates: false;
-    managedBy: "aidlc-kit" | "aidlc-workflow";
-    adapters: AgentId[];
-    files: Record<string, ManifestInventoryItem>;
-}
-export interface Diagnostic {
-    level: "ERROR" | "WARN" | "INFO";
-    code: string;
-    message: string;
-}
+/**
+ * Facade for the shared type hub. Behavior-preserving re-export of the split
+ * modules under `src/model/`; import paths from outside remain unchanged.
+ */
+export type { AgentId, StateMutationMode, Phase, Gate, TaskStatus, RiskLevel, DecisionStatus, HandoffKind, Diagnostic } from "./model/lifecycle-enums.js";
+export type { FileSpec, Adapter, PlannedWrite, InitOptions } from "./model/install-contracts.js";
+export type { LoopMode, LoopAgent, LoopConfig, LoopLimits } from "./model/loop.js";
+export { LOOP_PROVIDERS } from "./model/loop.js";
+export type { CommandSpec, Profile, ProjectConfig, McpConfig, TrackerConfig } from "./model/config-contracts.js";
+export type { TaskDecision, Evidence, LessonRecord, LessonDisposition, TaskState, WorkflowState, ArchivedTaskSummary, LessonIndexEntry, LessonIndex, AgenticMemoryEntry, AgenticMemoryRegistry } from "./model/records.js";
+export type { ManifestInventoryItem, WorkflowManifest } from "./model/manifest.js";

package/dist/src/model.js

@@ -1 +1 @@
-export const LOOP_PROVIDERS = Object.freeze(["codex", "claude", "opencode"]);
+export { LOOP_PROVIDERS } from "./model/loop.js";

package/dist/src/profiles.d.ts

@@ -5,6 +5,8 @@ export declare const validateLoopConfig: (value: unknown) => LoopConfig;
 /** Validates a single profile file (built-in or local). */
 export declare const validateProfile: (value: unknown, label?: string) => Profile;
 export declare const defaultConfig: () => ProjectConfig;
+/** Validates and normalizes a parsed `.agents/config.json` value. */
+export declare const validateProjectConfig: (value: unknown) => ProjectConfig;
 /** Loads and validates `.agents/config.json`, falling back to the default config when absent. */
 export declare const loadProjectConfig: (root: string) => ProjectConfig;
 /** Resolves a list of profile ids into an ordered, cycle-free list of profiles. */