@njeybe/nativ 2.0.0

package/dist/scanner/types.d.ts

@@ -0,0 +1,80 @@
+export interface ProjectInfo {
+    projectName: string;
+    projectType: string;
+    projectGoal: string;
+    runtime: string;
+    framework: string;
+    databaseOrm: string;
+    styling: string;
+    testing: string;
+    packageManager: string;
+    sourceRoot: string;
+    architecturePattern: string;
+    keyDirectories: string[];
+    verificationCommand: string;
+    repositoryType: string;
+    monorepoWorkspaces: string[];
+    detectedOrmConfig: string;
+    ecosystemManifests: string[];
+}
+export type SubagentType = 'backend' | 'frontend' | 'database' | 'qa-tester' | 'flutter-developer' | 'devops-agent' | 'security-auditor' | 'db-migration' | 'database-agent' | 'backend-agent' | 'frontend-agent' | 'qa-agent';
+export declare const SUBAGENT_TYPES: readonly SubagentType[];
+export declare function isSubagentType(value: string): value is SubagentType;
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
+export declare const TASK_STATUSES: readonly TaskStatus[];
+export interface MasterPlanTask {
+    id: string;
+    title: string;
+    description: string;
+    assignedSubagent: SubagentType;
+    dependencies: string[];
+    targetFiles: string[];
+    status: TaskStatus;
+    verificationCommand: string;
+    notes?: string;
+    /**
+     * Fast-path task: a small, self-contained change added outside the Tier-1 planned milestones
+     * (e.g. via `nativ task add --fast-path`). Absent or false means a planned task.
+     */
+    fastPath?: boolean;
+}
+/** Lists every structural problem with a task; empty when the task is valid. */
+export declare function validateMasterPlanTask(task: unknown): string[];
+export interface MasterPlanMilestone {
+    id: string;
+    name: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    tasks: MasterPlanTask[];
+    /** True for the milestone that collects fast-path tasks. */
+    fastPath?: boolean;
+}
+export interface MasterPlan {
+    $schema?: string;
+    version: string;
+    projectName: string;
+    lastUpdated: string;
+    overallStatus: 'pending' | 'in_progress' | 'completed';
+    activeMilestoneId: string;
+    milestones: MasterPlanMilestone[];
+}
+export type EscalationType = 'contract_drift' | 'schema_flaw' | 'missing_credential' | 'dependency_conflict' | 'architectural_ambiguity';
+export interface EscalationRecord {
+    id: string;
+    taskId: string;
+    type: EscalationType;
+    reportedBy: SubagentType;
+    timestamp: string;
+    summary: string;
+    details?: string;
+    affectedContracts: string[];
+    recommendedAction?: string;
+    status: 'pending_review' | 'resolved' | 'dismissed';
+    resolutionNotes?: string;
+}
+export interface EscalationFile {
+    $schema?: string;
+    version: string;
+    projectName: string;
+    lastUpdated: string;
+    escalations: EscalationRecord[];
+}

package/dist/scanner/types.js

@@ -0,0 +1,50 @@
+export const SUBAGENT_TYPES = [
+    'backend',
+    'frontend',
+    'database',
+    'qa-tester',
+    'flutter-developer',
+    'devops-agent',
+    'security-auditor',
+    'db-migration',
+    'database-agent',
+    'backend-agent',
+    'frontend-agent',
+    'qa-agent',
+];
+export function isSubagentType(value) {
+    return SUBAGENT_TYPES.includes(value);
+}
+export const TASK_STATUSES = ['pending', 'in_progress', 'completed', 'blocked'];
+/** Lists every structural problem with a task; empty when the task is valid. */
+export function validateMasterPlanTask(task) {
+    if (!task || typeof task !== 'object' || Array.isArray(task))
+        return ['task must be an object'];
+    const t = task;
+    const label = typeof t.id === 'string' && t.id ? `task "${t.id}"` : 'task';
+    const errors = [];
+    const isStringArray = (v) => Array.isArray(v) && v.every((x) => typeof x === 'string');
+    for (const field of ['id', 'title']) {
+        if (typeof t[field] !== 'string' || !t[field].trim())
+            errors.push(`${label}: "${field}" must be a non-empty string`);
+    }
+    if (typeof t.description !== 'string')
+        errors.push(`${label}: "description" must be a string`);
+    if (typeof t.verificationCommand !== 'string')
+        errors.push(`${label}: "verificationCommand" must be a string`);
+    if (typeof t.assignedSubagent !== 'string' || !isSubagentType(t.assignedSubagent)) {
+        errors.push(`${label}: "assignedSubagent" must be one of ${SUBAGENT_TYPES.join(', ')}`);
+    }
+    if (typeof t.status !== 'string' || !TASK_STATUSES.includes(t.status)) {
+        errors.push(`${label}: "status" must be one of ${TASK_STATUSES.join(', ')}`);
+    }
+    if (!isStringArray(t.dependencies))
+        errors.push(`${label}: "dependencies" must be an array of task IDs`);
+    if (!isStringArray(t.targetFiles))
+        errors.push(`${label}: "targetFiles" must be an array of paths`);
+    if (t.notes !== undefined && typeof t.notes !== 'string')
+        errors.push(`${label}: "notes" must be a string`);
+    if (t.fastPath !== undefined && typeof t.fastPath !== 'boolean')
+        errors.push(`${label}: "fastPath" must be a boolean`);
+    return errors;
+}

package/dist/server/studio-server.d.ts

@@ -0,0 +1,39 @@
+import http from 'node:http';
+import type { DatabaseEnv, DatabaseStatus, TableSchema } from '../db/types.js';
+import { type Tier1LiaisonOptions } from '../core/tier1-liaison.js';
+import { type AgentSupervisorOptions } from '../runner/agent-supervisor.js';
+/**
+ * Embedded Studio HTTP server (native node:http).
+ * Serves the REST endpoints from .ai/api_contracts.json plus the dashboard page.
+ *
+ * Air-gap rules: binds to loopback only, keeps raw connection URLs in this process's
+ * memory, and only ever returns masked URLs in responses.
+ */
+export declare const DEFAULT_STUDIO_PORT = 4983;
+export interface StudioServerOptions {
+    port?: number;
+    host?: string;
+    cwd?: string;
+    /** Dashboard HTML served at `/`. */
+    html?: string | (() => string);
+    /** Pre-seeded connection URLs; defaults to those resolved from .env files. */
+    connections?: Partial<Record<DatabaseEnv, string | null>>;
+    /** Interval between `heartbeat` events on /api/events. Defaults to 15s. */
+    heartbeatMs?: number;
+    /** Agent supervisor tuning (runner command, timeout budget, log buffer size). `cwd` is always the project root. */
+    supervisor?: Omit<AgentSupervisorOptions, 'cwd'>;
+    /** Tier 1 strategist transport (API key, model, fetch). Defaults to GEMINI_API_KEY and native fetch. */
+    triage?: Tier1LiaisonOptions;
+}
+export interface StudioServerHandle {
+    server: http.Server;
+    url: string;
+    port: number;
+    close(): Promise<void>;
+}
+/** Writes structure-only table metadata into .ai/db_schema.json, preserving other contract fields. */
+export declare function writeContractSchema(cwd: string, status: DatabaseStatus, tables: TableSchema[]): string;
+export declare const DEFAULT_HEARTBEAT_MS = 15000;
+export declare function createStudioServer(options?: StudioServerOptions): http.Server;
+/** Starts the studio on loopback, trying up to 10 consecutive ports if the preferred one is busy. */
+export declare function startStudioServer(options?: StudioServerOptions): Promise<StudioServerHandle>;