@forge-core/types 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,333 @@
+//#region src/state.d.ts
+interface ProjectState {
+  name: string;
+  description: string;
+  goals: string[];
+  constraints: string[];
+  current_phase: string;
+  current_status: ProjectStatus;
+  created_at: string;
+  updated_at: string;
+}
+type ProjectStatus = 'intake' | 'planning' | 'executing' | 'reviewing' | 'shipping' | 'shipped';
+interface ArchitectureState {
+  design_summary: string;
+  technical_decisions: Decision[];
+  open_questions: string[];
+  dependencies: Dependency[];
+  risk_register: Risk[];
+  updated_at: string;
+}
+interface Decision {
+  decision_id: string;
+  title: string;
+  description: string;
+  rationale: string;
+  status: DecisionStatus;
+  created_at: string;
+}
+type DecisionStatus = 'proposed' | 'accepted' | 'superseded';
+interface Dependency {
+  name: string;
+  version: string | null;
+  type: 'runtime' | 'dev' | 'peer' | 'optional';
+  notes: string;
+}
+interface Risk {
+  id: string;
+  description: string;
+  severity: RiskSeverity;
+  mitigation: string;
+  status: RiskStatus;
+}
+type RiskSeverity = 'low' | 'medium' | 'high' | 'critical';
+type RiskStatus = 'open' | 'mitigated' | 'accepted';
+interface ExecutionState {
+  phases: Phase[];
+  current_wave: number;
+  total_tasks: number;
+  tasks_done: number;
+  tasks_in_progress: number;
+  tasks_blocked: number;
+  updated_at: string;
+}
+interface Phase {
+  phase_id: string;
+  name: string;
+  description: string;
+  task_ids: string[];
+  status: PhaseStatus;
+}
+type PhaseStatus = 'pending' | 'active' | 'complete';
+interface ContextState {
+  session_id: string;
+  estimated_tokens_used: number;
+  budget_warning_threshold: number;
+  context_window_estimate: number;
+  last_snapshot: string | null;
+  last_digest_at: string;
+  recent_actions: string[];
+  updated_at: string;
+}
+//#endregion
+//#region src/task.d.ts
+type TaskStatus = 'draft' | 'planned' | 'ready' | 'in_progress' | 'blocked' | 'in_review' | 'qa_pending' | 'done' | 'rejected';
+declare const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;
+type OwnerRole = 'builder' | 'manager' | 'executive';
+interface AcceptanceCriterion {
+  id: string;
+  description: string;
+  verified: boolean;
+  evidence_ref: string | null;
+}
+type TestType = 'unit' | 'integration' | 'e2e';
+type TestStatus = 'pending' | 'written' | 'passing' | 'failing';
+interface TestRequirement {
+  type: TestType;
+  description: string;
+  test_file: string | null;
+  status: TestStatus;
+}
+type EvidenceType = 'test_result' | 'screenshot' | 'review' | 'log' | 'manual';
+interface Evidence {
+  type: EvidenceType;
+  description: string;
+  artifact_path: string;
+  created_at: string;
+}
+interface FileChange {
+  path: string;
+  operation: 'added' | 'modified' | 'deleted';
+}
+interface TestRunResult {
+  test_file: string;
+  passed: number;
+  failed: number;
+  skipped: number;
+  duration_ms: number;
+  output: string | null;
+}
+type CriterionStatus = {
+  criterion_id: string;
+  passed: boolean;
+  notes: string | null;
+};
+interface Task {
+  task_id: string;
+  title: string;
+  description: string;
+  rationale: string;
+  phase: string;
+  owner_role: OwnerRole;
+  dependencies: string[];
+  files_in_scope: string[];
+  constraints: string[];
+  acceptance_criteria: AcceptanceCriterion[];
+  test_requirements: TestRequirement[];
+  review_requirements: string[];
+  qa_requirements: string[];
+  status: TaskStatus;
+  evidence: Evidence[];
+  result: ExecutorResult | null;
+  created_at: string;
+  updated_at: string;
+}
+interface ExecutorResult {
+  task_id: string;
+  status: 'completed' | 'failed' | 'partial';
+  summary: string;
+  files_changed: FileChange[];
+  tests_added: string[];
+  tests_run: TestRunResult[];
+  acceptance_criteria_status: CriterionStatus[];
+  issues: string[];
+  merge_recommendation: 'merge' | 'revise' | 'reject';
+}
+//#endregion
+//#region src/executor.d.ts
+interface ExecutorConfig {
+  name: string;
+  options: Record<string, unknown>;
+}
+interface TaskContext {
+  task_id: string;
+  context_pack: ContextPackRef;
+  working_directory: string;
+}
+interface ContextPackRef {
+  pack_id: string;
+  estimated_tokens: number;
+  content: string;
+}
+interface Executor {
+  readonly name: string;
+  initialize(config: ExecutorConfig): Promise<void>;
+  dispatch(context: TaskContext): Promise<ExecutorResult>;
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region src/verifier.d.ts
+type VerificationType = 'unit' | 'integration' | 'e2e' | 'browser';
+interface VerifierConfig {
+  name: string;
+  options: Record<string, unknown>;
+}
+interface VerificationPlan {
+  plan_id: string;
+  task_ids: string[];
+  scope: 'task' | 'phase' | 'full';
+  changed_files: string[];
+  acceptance_criteria_ids: string[];
+  strategies: VerificationType[];
+}
+interface CheckResult {
+  name: string;
+  type: VerificationType;
+  status: 'pass' | 'fail' | 'skip';
+  duration_ms: number;
+  output: string | null;
+}
+interface EvidenceArtifact {
+  type: 'screenshot' | 'console_log' | 'network_log' | 'test_output' | 'coverage';
+  path: string;
+  description: string;
+}
+interface Issue {
+  severity: 'critical' | 'major' | 'minor' | 'info';
+  description: string;
+  file: string | null;
+  task_id: string | null;
+  auto_reopen: boolean;
+}
+interface VerificationResult {
+  plan_id: string;
+  status: 'pass' | 'fail' | 'partial';
+  checks: CheckResult[];
+  evidence: EvidenceArtifact[];
+  issues: Issue[];
+  summary: string;
+  created_at: string;
+}
+interface Verifier {
+  readonly name: string;
+  readonly supports: VerificationType[];
+  initialize(config: VerifierConfig): Promise<void>;
+  verify(plan: VerificationPlan): Promise<VerificationResult>;
+  dispose(): Promise<void>;
+}
+//#endregion
+//#region src/context.d.ts
+type DigestType = 'state' | 'decision' | 'changes' | 'next_step';
+interface ContextPackSections {
+  objective: string;
+  task: Task | null;
+  constraints: string[];
+  relevant_decisions: Decision[];
+  relevant_files: string[];
+  recent_changes: string[];
+  open_issues: string[];
+  state_digest: string;
+}
+interface ContextPack {
+  pack_id: string;
+  generated_at: string;
+  target_role: OwnerRole;
+  target_task: string | null;
+  estimated_tokens: number;
+  sections: ContextPackSections;
+}
+interface ContextBudget {
+  estimated_tokens_used: number;
+  context_window_estimate: number;
+  budget_warning_threshold: number;
+  warning_active: boolean;
+  recommendation: string | null;
+}
+interface Digest {
+  type: DigestType;
+  content: string;
+  generated_at: string;
+}
+interface Snapshot {
+  snapshot_id: string;
+  label: string | null;
+  created_at: string;
+  data: SnapshotData;
+}
+interface SnapshotData {
+  project: unknown;
+  architecture: unknown;
+  execution: unknown;
+  context: unknown;
+  task_index: Record<string, unknown>;
+  decision_index: Record<string, unknown>;
+}
+//#endregion
+//#region src/review.d.ts
+type ReviewType = 'architecture' | 'implementation' | 'qa' | 'ship';
+type ReviewVerdict = 'approved' | 'rejected' | 'conditional';
+interface ChecklistItem {
+  item: string;
+  passed: boolean;
+  note: string | null;
+}
+interface ReviewArtifact {
+  review_id: string;
+  type: ReviewType;
+  task_ids: string[];
+  reviewer_role: 'executive';
+  verdict: ReviewVerdict;
+  checklist: ChecklistItem[];
+  findings: string[];
+  required_actions: string[];
+  created_at: string;
+}
+declare const REVIEW_CHECKLISTS: Record<ReviewType, string[]>;
+//#endregion
+//#region src/config.d.ts
+interface VerifierConfigEntry {
+  name: string;
+  package: string | null;
+  options: Record<string, unknown>;
+}
+interface ForgeConfig {
+  project: {
+    name: string;
+    description: string;
+    goals: string[];
+  };
+  adapter: {
+    executor: string;
+    executor_options: Record<string, unknown>;
+  };
+  verification: {
+    verifiers: VerifierConfigEntry[];
+    default_strategy: VerificationType[];
+  };
+  context: {
+    budget_warning_threshold: number;
+    context_window_estimate: number;
+    auto_digest_on_merge: boolean;
+  };
+  testing: {
+    test_command: string;
+    test_pattern: string;
+    coverage_command: string | null;
+  };
+  review: {
+    require_architecture_review: boolean;
+    require_qa_before_ship: boolean;
+    auto_review_on_merge: boolean;
+  };
+  ids: {
+    task_counter: number;
+    decision_counter: number;
+    review_counter: number;
+    qa_counter: number;
+    snapshot_counter: number;
+  };
+}
+declare const DEFAULT_CONFIG: ForgeConfig;
+//#endregion
+export { AcceptanceCriterion, ArchitectureState, CheckResult, ChecklistItem, ContextBudget, ContextPack, ContextPackRef, ContextPackSections, ContextState, CriterionStatus, DEFAULT_CONFIG, Decision, DecisionStatus, Dependency, Digest, DigestType, Evidence, EvidenceArtifact, EvidenceType, ExecutionState, Executor, ExecutorConfig, type ExecutorResult, FileChange, ForgeConfig, Issue, OwnerRole, Phase, PhaseStatus, ProjectState, ProjectStatus, REVIEW_CHECKLISTS, ReviewArtifact, ReviewType, ReviewVerdict, Risk, RiskSeverity, RiskStatus, Snapshot, SnapshotData, TASK_TRANSITIONS, Task, TaskContext, TaskStatus, TestRequirement, TestRunResult, TestStatus, TestType, VerificationPlan, VerificationResult, VerificationType, Verifier, VerifierConfig, VerifierConfigEntry };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/state.ts","../src/task.ts","../src/executor.ts","../src/verifier.ts","../src/context.ts","../src/review.ts","../src/config.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,94 @@
+//#region src/task.ts
+const TASK_TRANSITIONS = {
+	draft: ["planned"],
+	planned: ["ready"],
+	ready: ["in_progress"],
+	in_progress: ["blocked", "in_review"],
+	blocked: ["in_progress"],
+	in_review: ["rejected", "qa_pending"],
+	rejected: ["in_progress"],
+	qa_pending: ["done", "in_progress"],
+	done: []
+};
+//#endregion
+//#region src/review.ts
+const REVIEW_CHECKLISTS = {
+	architecture: [
+		"Design is coherent and matches stated goals",
+		"Risks are identified and have mitigations",
+		"Dependencies are justified and minimal",
+		"Scope is appropriate — not over- or under-engineered",
+		"Test strategy covers the implementation",
+		"No unresolved design questions block execution"
+	],
+	implementation: [
+		"Code matches the task specification",
+		"No scope creep — only files_in_scope were modified",
+		"Tests exist for all acceptance criteria",
+		"All tests pass",
+		"No obvious defects or unhandled error paths",
+		"Evidence is attached"
+	],
+	qa: [
+		"All acceptance criteria are verified with evidence",
+		"No regressions introduced",
+		"Error handling works correctly",
+		"Edge cases are covered",
+		"Evidence artifacts are present and readable"
+	],
+	ship: [
+		"All tasks are in done status",
+		"All implementation reviews are approved",
+		"All QA reviews are passed",
+		"No open blockers remain",
+		"Decision log is complete",
+		"State is consistent and accurate"
+	]
+};
+//#endregion
+//#region src/config.ts
+const DEFAULT_CONFIG = {
+	project: {
+		name: "",
+		description: "",
+		goals: []
+	},
+	adapter: {
+		executor: "claude-code",
+		executor_options: {}
+	},
+	verification: {
+		verifiers: [{
+			name: "test-runner",
+			package: null,
+			options: {}
+		}],
+		default_strategy: ["unit"]
+	},
+	context: {
+		budget_warning_threshold: 8e4,
+		context_window_estimate: 128e3,
+		auto_digest_on_merge: true
+	},
+	testing: {
+		test_command: "npm test",
+		test_pattern: "**/*.test.ts",
+		coverage_command: null
+	},
+	review: {
+		require_architecture_review: true,
+		require_qa_before_ship: true,
+		auto_review_on_merge: false
+	},
+	ids: {
+		task_counter: 0,
+		decision_counter: 0,
+		review_counter: 0,
+		qa_counter: 0,
+		snapshot_counter: 0
+	}
+};
+//#endregion
+export { DEFAULT_CONFIG, REVIEW_CHECKLISTS, TASK_TRANSITIONS };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/task.ts","../src/review.ts","../src/config.ts"],"sourcesContent":["export type TaskStatus =\n  | 'draft'\n  | 'planned'\n  | 'ready'\n  | 'in_progress'\n  | 'blocked'\n  | 'in_review'\n  | 'qa_pending'\n  | 'done'\n  | 'rejected'\n\n// Valid transitions: key status -> array of allowed next statuses\nexport const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]> = {\n  draft:       ['planned'],\n  planned:     ['ready'],\n  ready:       ['in_progress'],\n  in_progress: ['blocked', 'in_review'],\n  blocked:     ['in_progress'],\n  in_review:   ['rejected', 'qa_pending'],\n  rejected:    ['in_progress'],\n  qa_pending:  ['done', 'in_progress'],\n  done:        [],\n}\n\nexport type OwnerRole = 'builder' | 'manager' | 'executive'\n\nexport interface AcceptanceCriterion {\n  id: string\n  description: string\n  verified: boolean\n  evidence_ref: string | null\n}\n\nexport type TestType = 'unit' | 'integration' | 'e2e'\nexport type TestStatus = 'pending' | 'written' | 'passing' | 'failing'\n\nexport interface TestRequirement {\n  type: TestType\n  description: string\n  test_file: string | null\n  status: TestStatus\n}\n\nexport type EvidenceType = 'test_result' | 'screenshot' | 'review' | 'log' | 'manual'\n\nexport interface Evidence {\n  type: EvidenceType\n  description: string\n  artifact_path: string\n  created_at: string  // ISO 8601\n}\n\nexport interface FileChange {\n  path: string\n  operation: 'added' | 'modified' | 'deleted'\n}\n\nexport interface TestRunResult {\n  test_file: string\n  passed: number\n  failed: number\n  skipped: number\n  duration_ms: number\n  output: string | null\n}\n\nexport type CriterionStatus = {\n  criterion_id: string\n  passed: boolean\n  notes: string | null\n}\n\nexport interface Task {\n  task_id: string                          // e.g., \"TASK-001\"\n  title: string\n  description: string\n  rationale: string\n  phase: string                            // phase_id reference\n  owner_role: OwnerRole\n  dependencies: string[]                   // task_id references\n  files_in_scope: string[]\n  constraints: string[]\n  acceptance_criteria: AcceptanceCriterion[]\n  test_requirements: TestRequirement[]\n  review_requirements: string[]\n  qa_requirements: string[]\n  status: TaskStatus\n  evidence: Evidence[]\n  result: ExecutorResult | null            // populated when worker completes\n  created_at: string\n  updated_at: string\n}\n\n// Forward reference — ExecutorResult will be defined in executor.ts\n// We need a minimal inline type here to avoid circular imports\nexport interface ExecutorResult {\n  task_id: string\n  status: 'completed' | 'failed' | 'partial'\n  summary: string\n  files_changed: FileChange[]\n  tests_added: string[]\n  tests_run: TestRunResult[]\n  acceptance_criteria_status: CriterionStatus[]\n  issues: string[]\n  merge_recommendation: 'merge' | 'revise' | 'reject'\n}\n","export type ReviewType = 'architecture' | 'implementation' | 'qa' | 'ship'\nexport type ReviewVerdict = 'approved' | 'rejected' | 'conditional'\n\nexport interface ChecklistItem {\n  item: string\n  passed: boolean\n  note: string | null\n}\n\nexport interface ReviewArtifact {\n  review_id: string         // e.g., \"REV-001\"\n  type: ReviewType\n  task_ids: string[]\n  reviewer_role: 'executive'\n  verdict: ReviewVerdict\n  checklist: ChecklistItem[]\n  findings: string[]\n  required_actions: string[]\n  created_at: string\n}\n\n// Checklist templates — the canonical items for each review type\nexport const REVIEW_CHECKLISTS: Record<ReviewType, string[]> = {\n  architecture: [\n    'Design is coherent and matches stated goals',\n    'Risks are identified and have mitigations',\n    'Dependencies are justified and minimal',\n    'Scope is appropriate — not over- or under-engineered',\n    'Test strategy covers the implementation',\n    'No unresolved design questions block execution',\n  ],\n  implementation: [\n    'Code matches the task specification',\n    'No scope creep — only files_in_scope were modified',\n    'Tests exist for all acceptance criteria',\n    'All tests pass',\n    'No obvious defects or unhandled error paths',\n    'Evidence is attached',\n  ],\n  qa: [\n    'All acceptance criteria are verified with evidence',\n    'No regressions introduced',\n    'Error handling works correctly',\n    'Edge cases are covered',\n    'Evidence artifacts are present and readable',\n  ],\n  ship: [\n    'All tasks are in done status',\n    'All implementation reviews are approved',\n    'All QA reviews are passed',\n    'No open blockers remain',\n    'Decision log is complete',\n    'State is consistent and accurate',\n  ],\n}\n","import type { VerificationType } from './verifier.js'\n\nexport interface VerifierConfigEntry {\n  name: string\n  package: string | null\n  options: Record<string, unknown>\n}\n\nexport interface ForgeConfig {\n  project: {\n    name: string\n    description: string\n    goals: string[]\n  }\n  adapter: {\n    executor: string\n    executor_options: Record<string, unknown>\n  }\n  verification: {\n    verifiers: VerifierConfigEntry[]\n    default_strategy: VerificationType[]\n  }\n  context: {\n    budget_warning_threshold: number\n    context_window_estimate: number\n    auto_digest_on_merge: boolean\n  }\n  testing: {\n    test_command: string\n    test_pattern: string\n    coverage_command: string | null\n  }\n  review: {\n    require_architecture_review: boolean\n    require_qa_before_ship: boolean\n    auto_review_on_merge: boolean\n  }\n  ids: {\n    task_counter: number\n    decision_counter: number\n    review_counter: number\n    qa_counter: number\n    snapshot_counter: number\n  }\n}\n\nexport const DEFAULT_CONFIG: ForgeConfig = {\n  project: {\n    name: '',\n    description: '',\n    goals: [],\n  },\n  adapter: {\n    executor: 'claude-code',\n    executor_options: {},\n  },\n  verification: {\n    verifiers: [{ name: 'test-runner', package: null, options: {} }],\n    default_strategy: ['unit'],\n  },\n  context: {\n    budget_warning_threshold: 80000,\n    context_window_estimate: 128000,\n    auto_digest_on_merge: true,\n  },\n  testing: {\n    test_command: 'npm test',\n    test_pattern: '**/*.test.ts',\n    coverage_command: null,\n  },\n  review: {\n    require_architecture_review: true,\n    require_qa_before_ship: true,\n    auto_review_on_merge: false,\n  },\n  ids: {\n    task_counter: 0,\n    decision_counter: 0,\n    review_counter: 0,\n    qa_counter: 0,\n    snapshot_counter: 0,\n  },\n}\n"],"mappings":";AAYA,MAAa,mBAAqD;CAChE,OAAa,CAAC,UAAU;CACxB,SAAa,CAAC,QAAQ;CACtB,OAAa,CAAC,cAAc;CAC5B,aAAa,CAAC,WAAW,YAAY;CACrC,SAAa,CAAC,cAAc;CAC5B,WAAa,CAAC,YAAY,aAAa;CACvC,UAAa,CAAC,cAAc;CAC5B,YAAa,CAAC,QAAQ,cAAc;CACpC,MAAa,EAAE;CAChB;;;ACAD,MAAa,oBAAkD;CAC7D,cAAc;EACZ;EACA;EACA;EACA;EACA;EACA;EACD;CACD,gBAAgB;EACd;EACA;EACA;EACA;EACA;EACA;EACD;CACD,IAAI;EACF;EACA;EACA;EACA;EACA;EACD;CACD,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACD;CACF;;;ACRD,MAAa,iBAA8B;CACzC,SAAS;EACP,MAAM;EACN,aAAa;EACb,OAAO,EAAE;EACV;CACD,SAAS;EACP,UAAU;EACV,kBAAkB,EAAE;EACrB;CACD,cAAc;EACZ,WAAW,CAAC;GAAE,MAAM;GAAe,SAAS;GAAM,SAAS,EAAE;GAAE,CAAC;EAChE,kBAAkB,CAAC,OAAO;EAC3B;CACD,SAAS;EACP,0BAA0B;EAC1B,yBAAyB;EACzB,sBAAsB;EACvB;CACD,SAAS;EACP,cAAc;EACd,cAAc;EACd,kBAAkB;EACnB;CACD,QAAQ;EACN,6BAA6B;EAC7B,wBAAwB;EACxB,sBAAsB;EACvB;CACD,KAAK;EACH,cAAc;EACd,kBAAkB;EAClB,gBAAgB;EAChB,YAAY;EACZ,kBAAkB;EACnB;CACF"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@forge-core/types",
+  "version": "0.1.0",
+  "description": "Shared TypeScript types for the Forge AI coding agent",
+  "keywords": [
+    "forge",
+    "ai",
+    "coding-agent"
+  ],
+  "author": "Forge",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fchery87/FORGE"
+  },
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}