@tangle-network/starter-foundry 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,309 @@
+export interface FileEntry {
+    source: string;
+    target: string;
+}
+export interface MediaSlot {
+    id: string;
+    path: string;
+    width: number;
+    height: number;
+    purpose: string;
+    prompt: string;
+    fallback: 'gradient' | 'icon' | 'initials' | 'text' | 'none';
+    usedIn: string;
+}
+export interface MediaManifest {
+    slots: MediaSlot[];
+}
+export type ValidationCheckType = 'file-exists' | 'node-syntax' | 'http-start' | 'command-success' | 'python-compile';
+export interface ValidationCheck {
+    type: ValidationCheckType;
+    path?: string;
+    command?: string[];
+    expect?: string;
+    env?: Record<string, string>;
+    port?: string;
+    runOnce?: boolean;
+}
+export interface PreviewHint {
+    path?: string;
+    port?: string | number;
+}
+export interface ContextHints {
+    commands?: string[];
+    entrypoints?: string[];
+    preview?: PreviewHint;
+    extensionPoints?: string[];
+}
+export interface SlotConfig {
+    options?: string[];
+    default?: string;
+}
+export interface TaxonomyFields {
+    language?: string;
+    runtime?: string;
+    surface?: string;
+}
+interface ManifestBase {
+    id: string;
+    description: string;
+    manifestPath: string;
+    baseDir: string;
+    files?: FileEntry[];
+    validationChecks?: ValidationCheck[];
+    contextHints?: ContextHints;
+    defaults?: Record<string, unknown>;
+}
+export interface FamilyManifest extends ManifestBase {
+    kind: 'family';
+    group: null;
+    tags: string[];
+    taxonomy?: TaxonomyFields;
+    slots?: Record<string, SlotConfig>;
+    /** Layer IDs that must be present (via layers array or slot selection) for this family to compose correctly. */
+    requires?: string[];
+    /** Flat keywords for prompt routing (legacy — prefer tieredKeywords). */
+    keywords?: string[];
+    /** Tiered keywords for weighted scoring. tier1 (4pts): framework names. tier2 (2pts): domain terms. tier3 (1pt): generic. archetypes (3pts): product patterns. */
+    tieredKeywords?: {
+        tier1?: string[];
+        tier2?: string[];
+        tier3?: string[];
+        archetypes?: string[];
+    };
+    /** Scoring boosts: when a boost key (e.g. "go") co-occurs with an API term, add boost value to score. */
+    scoring?: {
+        boost?: Record<string, number>;
+    };
+}
+export interface LayerManifest extends ManifestBase {
+    kind: 'layer';
+    group: string;
+    slot?: string;
+    appliesTo?: string[];
+    /** Keywords for capability auto-detection. detectCapabilities scores prompts against these. */
+    keywords?: string[];
+    /** Other capability IDs that must be present when this capability is attached. */
+    capabilityRequires?: string[];
+    /** Available variant directory names under variants/. When present, compose picks one deterministically. */
+    variants?: string[];
+    /** Concrete build suggestions for the AI agent when this capability is active. */
+    buildHints?: BuildHints;
+}
+export interface PartnerManifest extends ManifestBase {
+    kind: 'partner';
+    group: null;
+    appliesTo?: string[];
+    slotDefaults?: Record<string, string>;
+}
+export interface Registry {
+    families: Map<string, FamilyManifest>;
+    layers: Map<string, LayerManifest>;
+    partners: Map<string, PartnerManifest>;
+}
+export interface ResolvedComponents {
+    family: FamilyManifest;
+    layers: LayerManifest[];
+    partner: PartnerManifest | null;
+    slotSelections: Record<string, string>;
+}
+export interface ComposeSpec {
+    projectName: string;
+    packageName?: string;
+    family: string;
+    layers?: string[];
+    partner?: string | null;
+    slots?: Record<string, string>;
+    variables?: Record<string, unknown>;
+    primaryArtifactTargetMs?: number;
+    /** Original user prompt that generated this spec. Passed through to the AI agent context. */
+    userPrompt?: string;
+}
+export interface BuildPlan {
+    goal: string;
+    architecture: string[];
+    pages: string[];
+    apiRoutes: string[];
+    components: string[];
+    dataModels: string[];
+    integrations: string[];
+    firstMoves: string[];
+    /** Natural-language design directives for the AI agent. Not CSS — English rules about aesthetics. */
+    designDirective: string | null;
+    /** shadcn preset code for `pnpm dlx shadcn@latest init --preset <code>` */
+    presetCode?: string | null;
+}
+export interface BuildHints {
+    pages?: string[];
+    apiRoutes?: string[];
+    components?: string[];
+    dataModels?: string[];
+    integrations?: string[];
+    architectureNotes?: string[];
+}
+export interface ProjectEntry {
+    id?: string;
+    path: string;
+    spec: ComposeSpec;
+}
+export interface NormalizedProjectEntry {
+    id: string;
+    path: string;
+    spec: ComposeSpec;
+}
+export interface LaunchPlanConfig {
+    primaryProjectId?: string;
+    primaryArtifact?: {
+        kind?: string;
+        path?: string;
+        port?: number | null;
+        targetMs?: number;
+    };
+    initialAgentMission?: string;
+}
+export interface WorkspaceSpec {
+    workspaceName: string;
+    userPrompt?: string;
+    launchPlan?: LaunchPlanConfig;
+    projects: ProjectEntry[];
+}
+export interface LaunchPlan {
+    primaryProjectId: string;
+    primaryArtifact: {
+        kind: string;
+        path: string;
+        port: number | null;
+        targetMs: number;
+    };
+    initialAgentMission: string;
+}
+export type Complexity = 'simple' | 'medium' | 'complex' | 'mostly-complex';
+export type Confidence = 'high' | 'medium' | 'low';
+export interface CorpusExpected {
+    kind: 'starter' | 'workspace';
+    family?: string;
+    slots?: Record<string, string>;
+    primaryProjectId?: string;
+    projectIds?: string[];
+    projectFamilies?: Record<string, string>;
+}
+export interface CorpusScenario {
+    id: string;
+    complexity: Complexity;
+    partner: string | null;
+    prompt: string;
+    expected?: CorpusExpected;
+}
+export interface SelectionResult {
+    confidence: Confidence;
+    spec: ComposeSpec;
+    fallbackUsed: boolean;
+    reasons: string[];
+}
+export interface StarterPromptPlan {
+    kind: 'starter';
+    confidence: Confidence;
+    reasons: string[];
+    spec: ComposeSpec;
+}
+export interface WorkspacePromptPlan {
+    kind: 'workspace';
+    confidence: Confidence;
+    reasons: string[];
+    spec: WorkspaceSpec;
+}
+export type PromptPlan = StarterPromptPlan | WorkspacePromptPlan;
+export interface ComposeComponents {
+    family: string;
+    layers: string[];
+    partner: string | null;
+    slots: Record<string, string>;
+}
+export interface ComposeResult {
+    outDir: string;
+    filesWritten: string[];
+    composeReportPath: string;
+    components: ComposeComponents;
+}
+export interface ValidationCheckResult {
+    ok: boolean;
+    check: ValidationCheck;
+    durationMs: number;
+    result?: unknown;
+    error?: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    outDir: string;
+    checks: ValidationCheckResult[];
+}
+export interface BenchmarkStats {
+    min: number;
+    max: number;
+    mean: number;
+    p50: number;
+    p95: number;
+    samples: number;
+}
+export interface BenchmarkRunResult {
+    runId: number;
+    outDir: string;
+    composeMs: number;
+    primaryArtifactMs: number;
+    primaryArtifactTargetMs: number;
+    meetsPrimaryArtifactTarget: boolean;
+    validateMs: number;
+    contextMs: number;
+    totalMs: number;
+    ok: boolean;
+    filesWritten: number;
+    checksPassed: number;
+    checksTotal: number;
+    contextPath: string;
+}
+export interface BenchmarkReport {
+    schemaVersion: 1;
+    generatedAt: string;
+    projectName: string;
+    runs: number;
+    results: BenchmarkRunResult[];
+    summary: {
+        composeMs: BenchmarkStats;
+        primaryArtifactMs: BenchmarkStats;
+        primaryArtifactTargetMs: number;
+        primaryArtifactHitRate: number;
+        validateMs: BenchmarkStats;
+        contextMs: BenchmarkStats;
+        totalMs: BenchmarkStats;
+        passRate: number;
+    };
+}
+export interface ContextPack {
+    schemaVersion: 1;
+    generatedAt: string;
+    projectName: string;
+    components: ComposeComponents;
+    variables: Record<string, unknown>;
+    files: string[];
+    fileOwnership: Record<string, string>;
+    commands: string[];
+    entrypoints: string[];
+    preview: PreviewHint | null;
+    extensionPoints: string[];
+    validationChecks: ValidationCheck[];
+    agentBrief: {
+        summary: string;
+        firstMoves: string[];
+    };
+    buildPlan?: BuildPlan;
+    userPrompt?: string | null;
+}
+export interface ComposeReport {
+    spec: ComposeSpec;
+    components: ComposeComponents;
+    variables: Record<string, unknown>;
+    fileOwnership: Record<string, string>;
+    validationChecks: ValidationCheck[];
+    contextHints: Required<ContextHints>;
+}
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@tangle-network/starter-foundry",
+  "version": "0.1.0",
+  "description": "Deterministic project scaffold engine for AI coding platforms",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tangle-network/starter-foundry.git"
+  },
+  "exports": {
+    ".": "./dist/lib/index.js",
+    "./planner": "./dist/lib/prompt-planner.js",
+    "./compose": "./dist/lib/compose.js",
+    "./registry": "./dist/lib/registry.js",
+    "./context": "./dist/lib/context-pack.js",
+    "./build-plan": "./dist/lib/build-plan.js",
+    "./workspace": "./dist/lib/workspace.js",
+    "./keywords": "./dist/lib/keywords.js",
+    "./types": "./dist/types.js"
+  },
+  "files": [
+    "dist/",
+    "registry/",
+    "corpus/",
+    "specs/"
+  ],
+  "bin": {
+    "starter-foundry": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "test": "tsc && tsc -p tsconfig.test.json && node --test dist-tests/*.test.js",
+    "catalog": "node dist/cli.js catalog",
+    "select": "node dist/cli.js select",
+    "compose": "node dist/cli.js compose",
+    "workspace:compose": "node dist/cli.js workspace-compose",
+    "validate": "node dist/cli.js validate",
+    "context": "node dist/cli.js context",
+    "workspace:context": "node dist/cli.js workspace-context",
+    "bench": "node dist/cli.js bench",
+    "workspace:bench": "node dist/cli.js workspace-bench",
+    "prompt:e2e": "node dist/cli.js prompt-e2e",
+    "prove": "node dist/cli.js prove",
+    "audit": "node dist/cli.js audit",
+    "evaluate": "node dist/cli.js evaluate",
+    "release": "node dist/cli.js release",
+    "sync:warm-list": "node scripts/sync-warm-list.mjs",
+    "sync:warm-list:write": "node scripts/sync-warm-list.mjs --write",
+    "audit:visual": "node scripts/visual-audit.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^4.0.0"
+  }
+}

package/registry/families/agent-service-py/files/requirements.txt

@@ -0,0 +1 @@
+# Intentionally lean. Add a concrete agent framework during hardening if needed.

package/registry/families/agent-service-py/manifest.json

@@ -0,0 +1,159 @@
+{
+  "id": "agent-service-py",
+  "description": "Python AI agent service starter with a small HTTP control plane.",
+  "tags": [
+    "ai",
+    "agent",
+    "python",
+    "service"
+  ],
+  "taxonomy": {
+    "language": "python",
+    "runtime": "python",
+    "surface": "agent-service"
+  },
+  "slots": {
+    "database": {
+      "options": [
+        "database:sqlite",
+        "database:postgres",
+        "database:mongodb",
+        "database:convex"
+      ],
+      "default": "database:sqlite"
+    },
+    "sdk": {
+      "options": [
+        "sdk:none",
+        "sdk:coinbase-cdp",
+        "sdk:solana-web3",
+        "sdk:evm-wallet"
+      ],
+      "default": "sdk:none"
+    },
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk",
+        "auth:supabase-auth"
+      ],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": [
+        "payments:none",
+        "payments:stripe",
+        "payments:coinbase-commerce"
+      ],
+      "default": "payments:none"
+    },
+    "queue": {
+      "options": [
+        "queue:none",
+        "queue:bullmq",
+        "queue:trigger-dev"
+      ],
+      "default": "queue:none"
+    }
+  },
+  "defaults": {
+    "projectType": "agent-service",
+    "serviceName": "starter-foundry-agent-py",
+    "port": 4193,
+    "agentLibrary": "pydanticai",
+    "agentSurface": "service"
+  },
+  "files": [
+    {
+      "source": "files/requirements.txt",
+      "target": "requirements.txt"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "app.py"
+    },
+    {
+      "type": "python-compile",
+      "path": "app.py"
+    },
+    {
+      "type": "http-start",
+      "command": [
+        "python3",
+        "app.py"
+      ],
+      "port": "{{port}}",
+      "path": "/health",
+      "expect": "\"agent\""
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "python3 app.py"
+    ],
+    "entrypoints": [
+      "app.py",
+      "agent.config.json"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "agent.config.json",
+      "sdk-config.json",
+      "queue-config.json",
+      "database-config.json"
+    ]
+  },
+  "keywords": [
+    "python agent",
+    "pydanticai",
+    "crewai",
+    "autogen",
+    "agno",
+    "llamaindex",
+    "agentkit",
+    "python chatbot",
+    "python assistant",
+    "unsloth",
+    "qlora"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "python agent",
+      "pydanticai",
+      "crewai",
+      "autogen",
+      "agno",
+      "llamaindex",
+      "python chatbot",
+      "python assistant",
+      "unsloth"
+    ],
+    "tier2": [
+      "agentkit",
+      "qlora"
+    ],
+    "archetypes": [
+      "custom gpt",
+      "train a gpt",
+      "fine-tune gpt",
+      "document ocr",
+      "ocr pipeline",
+      "text extraction",
+      "pdf parser",
+      "document parser",
+      "image upscaler",
+      "super resolution",
+      "image enhancer",
+      "upscale image",
+      "sentiment analysis",
+      "sentiment analyzer",
+      "opinion mining"
+    ]
+  }
+}

package/registry/families/agent-service-rust/manifest.json

@@ -0,0 +1,123 @@
+{
+  "id": "agent-service-rust",
+  "description": "Rust AI agent service starter for durable workers and infra-heavy agent runtimes.",
+  "tags": [
+    "ai",
+    "agent",
+    "rust",
+    "service"
+  ],
+  "taxonomy": {
+    "language": "rust",
+    "runtime": "rust",
+    "surface": "agent-service"
+  },
+  "slots": {
+    "database": {
+      "options": [
+        "database:sqlite",
+        "database:postgres",
+        "database:mongodb",
+        "database:convex"
+      ],
+      "default": "database:sqlite"
+    },
+    "sdk": {
+      "options": [
+        "sdk:none",
+        "sdk:coinbase-cdp",
+        "sdk:solana-web3",
+        "sdk:evm-wallet"
+      ],
+      "default": "sdk:none"
+    },
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk",
+        "auth:supabase-auth"
+      ],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": [
+        "payments:none",
+        "payments:stripe",
+        "payments:coinbase-commerce"
+      ],
+      "default": "payments:none"
+    },
+    "queue": {
+      "options": [
+        "queue:none",
+        "queue:bullmq",
+        "queue:trigger-dev"
+      ],
+      "default": "queue:none"
+    }
+  },
+  "defaults": {
+    "projectType": "agent-service",
+    "serviceName": "starter-foundry-agent-rust",
+    "port": 4194,
+    "agentLibrary": "rig",
+    "agentSurface": "service"
+  },
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "Cargo.toml"
+    },
+    {
+      "type": "http-start",
+      "command": [
+        "cargo",
+        "run",
+        "--quiet"
+      ],
+      "port": "{{port}}",
+      "path": "/health",
+      "expect": "\"agent\""
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "cargo run",
+      "cargo check"
+    ],
+    "entrypoints": [
+      "src/main.rs",
+      "Cargo.toml",
+      "agent.config.json"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "agent.config.json",
+      "sdk-config.json",
+      "queue-config.json",
+      "database-config.json"
+    ]
+  },
+  "keywords": [
+    "rust agent",
+    "rig",
+    "cargo agent",
+    "autonomous rust"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "rust agent",
+      "cargo agent",
+      "autonomous rust",
+      "rig",
+      "rust ai agent"
+    ],
+    "tier2": [
+      "rig"
+    ]
+  }
+}

package/registry/families/agent-service-ts/files/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "node agent.mjs"
+  }
+}