@tangle-network/starter-foundry 0.7.3 → 0.13.2

package/dist/types/planner.js

@@ -0,0 +1,4 @@
+// Planner / routing types — what selectStarter and planPrompt return,
+// how callers interpret confidence and risk.
+export {};
+//# sourceMappingURL=planner.js.map

package/dist/types/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/types/planner.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,6CAA6C"}

package/dist/types/registry-schemas.generated.d.ts

@@ -1,3 +1,44 @@
+/** Bundle-side spec; deploy script translates into a Tangle Sandbox AgentProfile and emits harness-native files (AGENTS.md, agents.json) at the workspace root. */
+export interface Agent {
+    "name": string;
+    "description"?: string;
+    "version": string;
+    "tags"?: Array<string>;
+    "harness"?: "opencode" | "claude-code" | "hermes";
+    "hooks"?: {
+        "pre"?: string;
+        "post"?: string;
+    };
+    "workspace"?: {
+        "root"?: string;
+    };
+    "prompt": {
+        "systemPromptFile"?: string;
+        "instructions"?: Array<string>;
+    };
+    "model"?: {
+        "preferred"?: string;
+        "fallback"?: Array<string>;
+    };
+    "tools"?: Record<string, boolean>;
+    "permissions"?: Record<string, "allow" | "ask" | "deny">;
+    "mcp"?: Record<string, unknown>;
+    "subagents"?: Record<string, {
+        "description"?: string;
+        "systemPromptFile": string;
+        "model"?: string;
+        "tools"?: Record<string, boolean>;
+        "permissions"?: Record<string, "allow" | "ask" | "deny">;
+        "temperature"?: number;
+        "maxSteps"?: number;
+    }>;
+    "resources"?: {
+        "files"?: Array<{
+            "source": string;
+            "target"?: string;
+        }>;
+    };
+}
 export interface Buildhints {
     "pages"?: Array<string>;
     "apiRoutes"?: Array<string>;
@@ -27,13 +68,14 @@ export interface Family {
         "default"?: string;
     }>;
     "requires"?: Array<string>;
+    "includes"?: Array<string>;
     "defaults"?: Record<string, unknown>;
     "files"?: Array<{
         "source": string;
         "target": string;
     }>;
     "validationChecks"?: Array<{
-        "type": "file-exists" | "node-syntax" | "http-start" | "command-success" | "python-compile";
+        "type": "file-exists" | "node-syntax" | "http-start" | "command-success" | "python-compile" | "prompt-frontmatter-valid" | "cron-syntax-valid" | "template-index-valid" | "agents-md-valid" | "methodology-index-valid" | "schedule-valid";
         "path"?: string;
         "command"?: Array<string>;
         "expect"?: string;
@@ -58,6 +100,31 @@ export interface Family {
         "boost"?: Record<string, number>;
     };
     "buildHints"?: Buildhints;
+    "domainPack"?: {
+        "domain": {
+            "family": string;
+            "provider"?: string;
+            "protocol"?: string;
+            "runtime"?: string;
+            "surface"?: string;
+        };
+        "provides": Array<string>;
+        "requires"?: Array<string>;
+        "ambiguityGroup"?: string;
+        "validationCommands"?: Array<string>;
+        "authenticitySignals"?: Array<string>;
+        "authenticityGroups"?: Array<{
+            "id": string;
+            "description"?: string;
+            "minRequired"?: number;
+            "signals": Array<string>;
+        }>;
+        "routingPrompts"?: Array<{
+            "prompt": string;
+            "expectedFamily"?: string;
+            "expectedLayers"?: Array<string>;
+        }>;
+    };
 }
 export interface Layer {
     "id": string;
@@ -90,6 +157,34 @@ export interface Layer {
         "dependencies"?: Record<string, string>;
         "devDependencies"?: Record<string, string>;
     };
+    "provides"?: Array<string>;
+    "requires"?: Array<string>;
+    "conflictsWith"?: Array<string>;
+    "domainPack"?: {
+        "domain": {
+            "family": string;
+            "provider"?: string;
+            "protocol"?: string;
+            "runtime"?: string;
+            "surface"?: string;
+        };
+        "provides": Array<string>;
+        "requires"?: Array<string>;
+        "ambiguityGroup"?: string;
+        "validationCommands"?: Array<string>;
+        "authenticitySignals"?: Array<string>;
+        "authenticityGroups"?: Array<{
+            "id": string;
+            "description"?: string;
+            "minRequired"?: number;
+            "signals": Array<string>;
+        }>;
+        "routingPrompts"?: Array<{
+            "prompt": string;
+            "expectedFamily"?: string;
+            "expectedLayers"?: Array<string>;
+        }>;
+    };
 }
 export interface Partner {
     "id": string;

package/dist/types/registry-schemas.generated.js

@@ -1,5 +1,5 @@
-// AUTO-GENERATED from registry/_schemas/*.json by scripts/gen-types-from-schemas.mjs.
+// AUTO-GENERATED from registry/_schemas/*.json by scripts/gen-types-from-schemas.ts.
 // Do not edit by hand — re-run the generator after schema changes.
-// `pnpm test` enforces this file is in sync via scripts/gen-types-from-schemas.mjs --check.
+// `pnpm test` enforces this file is in sync via scripts/gen-types-from-schemas.ts --check.
 export {};
 //# sourceMappingURL=registry-schemas.generated.js.map

package/dist/types/registry-schemas.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry-schemas.generated.js","sourceRoot":"","sources":["../../src/types/registry-schemas.generated.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,mEAAmE;AACnE,4FAA4F"}
+{"version":3,"file":"registry-schemas.generated.js","sourceRoot":"","sources":["../../src/types/registry-schemas.generated.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,mEAAmE;AACnE,2FAA2F"}

package/dist/types/registry.d.ts

@@ -0,0 +1,243 @@
+import type { CapabilityId, LayerId } from './ids.js';
+export interface FileEntry {
+    source: string;
+    target: string;
+}
+export type ValidationCheckType = 'file-exists' | 'node-syntax' | 'http-start' | 'command-success' | 'python-compile' | 'prompt-frontmatter-valid' | 'cron-syntax-valid' | 'template-index-valid' | 'agents-md-valid' | 'methodology-index-valid' | 'schedule-valid';
+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;
+}
+export interface BuildHints {
+    pages?: string[];
+    apiRoutes?: string[];
+    components?: string[];
+    dataModels?: string[];
+    integrations?: string[];
+    architectureNotes?: string[];
+    /**
+     * Domain-specific first moves an agent should make on this scaffold.
+     * Rendered as `## First moves` in AGENTS.md. Write concrete commands +
+     * file paths, not generic "familiarize yourself with the code" advice.
+     * Example (bun-http): "Use `bun add` not `pnpm add` for deps".
+     */
+    firstSteps?: string[];
+    /**
+     * Non-obvious traps specific to this runtime/stack. Rendered as
+     * `## Gotchas` in AGENTS.md. Each entry should name the failure mode
+     * + the fix. Not general "be careful" advice.
+     * Example (wasm-rust): "Proving keys are multi-MB — gitignore pkg/ and
+     * host the .wasm under public/ so Vite serves it."
+     */
+    gotchas?: string[];
+    /**
+     * One sentence on WHY an agent attaches or uses this surface.
+     * Rendered as the intro line of relevant AGENTS.md sections.
+     */
+    whenToUse?: string;
+    /**
+     * Scaffold files that ship DEFAULT / PLACEHOLDER content — the agent must
+     * replace them with product-specific behavior, not treat them as working
+     * infrastructure. Each entry is `{path, description}` — the path is
+     * relative to the composed scaffold root; description names what the
+     * default renders and what the agent should replace it with.
+     */
+    placeholders?: {
+        path: string;
+        description: string;
+    }[];
+}
+export interface DomainPackRoutingPrompt {
+    prompt: string;
+    expectedFamily?: string;
+    expectedLayers?: string[];
+}
+export interface DomainPackAuthenticityGroup {
+    id: string;
+    description?: string;
+    minRequired?: number;
+    signals: string[];
+}
+export interface DomainPackMetadata {
+    domain: {
+        /**
+         * Broad reusable domain family, e.g. `fhe`, `bridge`, `dex-hook`.
+         * This is intentionally not a starter-foundry family id.
+         */
+        family: string;
+        provider?: string;
+        protocol?: string;
+        runtime?: string;
+        surface?: string;
+    };
+    /** Capability/toolchain facts this manifest contributes to a composed scaffold. */
+    provides: string[];
+    /** Capability/toolchain facts this manifest expects from the chosen stack. */
+    requires?: string[];
+    /**
+     * Competing packs that need disambiguation. Example: all FHE contract
+     * families belong to `fhe-contracts` so generic FHE prompts can be marked
+     * ambiguous instead of silently picking Fhenix vs Zama or Foundry vs Hardhat.
+     */
+    ambiguityGroup?: string;
+    validationCommands?: string[];
+    authenticitySignals?: string[];
+    authenticityGroups?: DomainPackAuthenticityGroup[];
+    routingPrompts?: DomainPackRoutingPrompt[];
+}
+export interface DomainPackGuidance {
+    source: string;
+    domain: DomainPackMetadata['domain'];
+    provides: string[];
+    requires: string[];
+    ambiguityGroup: string | null;
+    validationCommands: string[];
+    authenticitySignals: string[];
+    authenticityGroups: DomainPackAuthenticityGroup[];
+}
+interface ManifestBase {
+    id: string;
+    description: string;
+    manifestPath: string;
+    baseDir: string;
+    files?: FileEntry[];
+    validationChecks?: ValidationCheck[];
+    contextHints?: ContextHints;
+    defaults?: Record<string, unknown>;
+    domainPack?: DomainPackMetadata;
+}
+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[];
+    /**
+     * Layer IDs to additively stack on every compose of this family —
+     * bypasses the slot mechanism. Use when the bundle wants multiple
+     * additional layers without needing N single-option slots (the
+     * agent-runtime tool-kit case: every bundle adds tangle-base + an
+     * arbitrary subset of tool kits + structured-output, no slot per kit).
+     * Format: `<group>:<id>` matching the layer registry.
+     */
+    includes?: LayerId[];
+    /** Flat keyword list. When `tieredKeywords` is also present, the tiered scorer takes precedence. */
+    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>;
+    };
+    /**
+     * Domain-specific build guidance — first moves, gotchas, architecture
+     * notes — written into the composed scaffold's AGENTS.md.
+     */
+    buildHints?: BuildHints;
+}
+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[];
+    /**
+     * Tiered keywords (same shape as FamilyManifest.tieredKeywords). Capability
+     * manifests use `tieredKeywords.archetypes` to declare their archetype
+     * signal arrays.
+     */
+    tieredKeywords?: {
+        tier1?: string[];
+        tier2?: string[];
+        tier3?: string[];
+        archetypes?: 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;
+    /**
+     * Packages this layer contributes to the composed scaffold's root package.json.
+     * Merged into the family's package.json at compose time so capability layers
+     * can actually ship their runtime deps instead of scaffolding config files and
+     * expecting the agent to figure out which package to install.
+     */
+    packageDeps?: {
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+    };
+    /**
+     * Capabilities this layer provides. Conflicts when two stacked layers
+     * provide the same capability — composer rejects unless the spec
+     * explicitly disambiguates. Format: `<scope>:<name>` or `<name>`.
+     */
+    provides?: CapabilityId[];
+    /**
+     * Capabilities this layer needs from the stack. Composer topo-sorts
+     * so providers run before requirers; missing capabilities fail loud
+     * at compose time with the specific name that's unsatisfied.
+     */
+    requires?: CapabilityId[];
+    /**
+     * Capabilities or layer IDs this layer is incompatible with. Compose
+     * rejects spec if a conflicting layer or capability is also stacked.
+     */
+    conflictsWith?: CapabilityId[];
+}
+export interface PartnerManifest extends ManifestBase {
+    kind: 'partner';
+    group: null;
+    appliesTo?: string[];
+    slotDefaults?: Record<string, string>;
+    /**
+     * Partner-specific agent guidance — which SDK to use, which env vars
+     * to set, ecosystem gotchas. Written into composed scaffold's AGENTS.md.
+     */
+    buildHints?: BuildHints;
+}
+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 {};

package/dist/types/registry.js

@@ -0,0 +1,4 @@
+// Registry types — manifests, validation checks, the in-memory Registry.
+// Anything the loader produces or the composer consumes from registry/.
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/types/registry.js.map

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