wingfoil 0.2.1

package/dist/workflow/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Phase = exports.Workflow = exports.WorkflowsYaml = exports.MODULE_NAME = void 0;
+/**
+ * `workflow` module — Project Workflow pillar; phases/steps/atomic actions, `include()` composition
+ * (P4.1). `workflows.yaml`'s Layer-1 manifest + Layer-2 Workflow DSL schemas
+ * (spec-003-workflows-yaml-schema) live here — the pillar owns its own independent schema
+ * (REQ-SYS-02); `src/core`'s loader wires it through the shared validation pipeline. Further
+ * Workflow behavior (engine execution, `wingfoil workflow *`) lands in later tasks.
+ */
+exports.MODULE_NAME = 'workflow';
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "WorkflowsYaml", { enumerable: true, get: function () { return schema_1.WorkflowsYaml; } });
+Object.defineProperty(exports, "Workflow", { enumerable: true, get: function () { return schema_1.Workflow; } });
+Object.defineProperty(exports, "Phase", { enumerable: true, get: function () { return schema_1.Phase; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,WAAW,GAAG,UAAmB,CAAC;AAE/C,mCAA0D;AAAjD,uGAAA,aAAa,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,+FAAA,KAAK,OAAA"}

package/dist/workflow/schema.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `workflows.yaml` manifest (Layer 1) + Workflow DSL (Layer 2) schemas
+ * (spec-003-workflows-yaml-schema, P4.1). This is one of the three independent per-pillar schemas
+ * task-004-decoupled-pillars keeps decoupled (REQ-SYS-02): neither layer depends on `memory.yaml`'s
+ * or `dna.yaml`'s schema. Cross-file concerns spec-003 itself calls out — resolving each `include`
+ * path against the filesystem, and requiring at least one loaded workflow to be `kind: main` — need
+ * the caller to have actually loaded the referenced files, so per spec-009-validation-strategy §1
+ * ("Cross-file ... these require the caller to have already loaded ... so they run as a list of
+ * caller-supplied SemanticCheck functions") those two checks live in the loader
+ * (`src/core/loaders.ts`), not in this schema module.
+ *
+ * Every object node is `.passthrough()` per spec-009 §2.
+ */
+import { z } from 'zod';
+/**
+ * Layer 1 — the main manifest (`.wingfoil/workflows.yaml`). `include` (singular) is the canonical
+ * key per spec-003's required rename from the legacy plural `includes:`; a document that still uses
+ * `includes:` fails Pass 1 here (missing required `include`) and `includes` itself is preserved only
+ * as an unknown, passed-through key.
+ */
+export declare const WorkflowsYaml: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    include: z.ZodArray<z.ZodString>;
+}, z.core.$loose>;
+export type WorkflowsYaml = z.infer<typeof WorkflowsYaml>;
+/**
+ * One `phases[]` entry of a Layer-2 workflow definition (spec-003) — a named step with its optional
+ * `role`, `actions`, `include`, `iterate_over`/`where`, `produces`, `checks`, `approval`, and
+ * `fallback`. `.passthrough()` per spec-009 §2.
+ */
+export declare const Phase: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    optional: z.ZodDefault<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    include: z.ZodOptional<z.ZodString>;
+    iterate_over: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>;
+    produces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    checks: z.ZodOptional<z.ZodObject<{
+        pre: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        post: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
+    approval: z.ZodOptional<z.ZodObject<{
+        by_role: z.ZodString;
+    }, z.core.$loose>>;
+    fallback: z.ZodOptional<z.ZodObject<{
+        step: z.ZodString;
+        set_state: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** Parsed shape of the {@link Phase} schema. */
+export type Phase = z.infer<typeof Phase>;
+/** Layer 2 — one workflow-definition file (`.wingfoil/workflows/**\/*.yaml`). */
+export declare const Workflow: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        sub: "sub";
+        main: "main";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
+    element: z.ZodOptional<z.ZodString>;
+    phases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        optional: z.ZodDefault<z.ZodBoolean>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        include: z.ZodOptional<z.ZodString>;
+        iterate_over: z.ZodOptional<z.ZodString>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>;
+        produces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        checks: z.ZodOptional<z.ZodObject<{
+            pre: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            post: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$loose>>;
+        approval: z.ZodOptional<z.ZodObject<{
+            by_role: z.ZodString;
+        }, z.core.$loose>>;
+        fallback: z.ZodOptional<z.ZodObject<{
+            step: z.ZodString;
+            set_state: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type Workflow = z.infer<typeof Workflow>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/workflow/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/workflow/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;iBAKV,CAAC;AACjB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAY1D;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;iBAkBF,CAAC;AACjB,gDAAgD;AAChD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,iFAAiF;AACjF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASL,CAAC;AACjB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/workflow/schema.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workflow = exports.Phase = exports.WorkflowsYaml = void 0;
+/**
+ * `workflows.yaml` manifest (Layer 1) + Workflow DSL (Layer 2) schemas
+ * (spec-003-workflows-yaml-schema, P4.1). This is one of the three independent per-pillar schemas
+ * task-004-decoupled-pillars keeps decoupled (REQ-SYS-02): neither layer depends on `memory.yaml`'s
+ * or `dna.yaml`'s schema. Cross-file concerns spec-003 itself calls out — resolving each `include`
+ * path against the filesystem, and requiring at least one loaded workflow to be `kind: main` — need
+ * the caller to have actually loaded the referenced files, so per spec-009-validation-strategy §1
+ * ("Cross-file ... these require the caller to have already loaded ... so they run as a list of
+ * caller-supplied SemanticCheck functions") those two checks live in the loader
+ * (`src/core/loaders.ts`), not in this schema module.
+ *
+ * Every object node is `.passthrough()` per spec-009 §2.
+ */
+const zod_1 = require("zod");
+/**
+ * Layer 1 — the main manifest (`.wingfoil/workflows.yaml`). `include` (singular) is the canonical
+ * key per spec-003's required rename from the legacy plural `includes:`; a document that still uses
+ * `includes:` fails Pass 1 here (missing required `include`) and `includes` itself is preserved only
+ * as an unknown, passed-through key.
+ */
+exports.WorkflowsYaml = zod_1.z
+    .object({
+    version: zod_1.z.number().positive().optional(),
+    include: zod_1.z.array(zod_1.z.string()).min(1),
+})
+    .passthrough();
+/** Free-form assertion string, e.g. `tests.coverage(min: 80)`, `frontmatter.required: [title]`. */
+const Check = zod_1.z.string();
+const WhereValue = zod_1.z.union([
+    zod_1.z.string(),
+    zod_1.z.number(),
+    zod_1.z.boolean(),
+    zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()])),
+]);
+/**
+ * One `phases[]` entry of a Layer-2 workflow definition (spec-003) — a named step with its optional
+ * `role`, `actions`, `include`, `iterate_over`/`where`, `produces`, `checks`, `approval`, and
+ * `fallback`. `.passthrough()` per spec-009 §2.
+ */
+exports.Phase = zod_1.z
+    .object({
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    role: zod_1.z.string().optional(),
+    optional: zod_1.z.boolean().default(false),
+    actions: zod_1.z.array(zod_1.z.string()).optional(),
+    include: zod_1.z.string().optional(),
+    iterate_over: zod_1.z.string().optional(),
+    where: zod_1.z.record(zod_1.z.string(), WhereValue).optional(),
+    produces: zod_1.z.array(zod_1.z.string()).optional(),
+    checks: zod_1.z
+        .object({ pre: zod_1.z.array(Check).optional(), post: zod_1.z.array(Check).optional() })
+        .passthrough()
+        .optional(),
+    approval: zod_1.z.object({ by_role: zod_1.z.string() }).passthrough().optional(),
+    fallback: zod_1.z.object({ step: zod_1.z.string(), set_state: zod_1.z.string().optional() }).passthrough().optional(),
+})
+    .passthrough();
+/** Layer 2 — one workflow-definition file (`.wingfoil/workflows/**\/*.yaml`). */
+exports.Workflow = zod_1.z
+    .object({
+    name: zod_1.z.string(),
+    kind: zod_1.z.enum(['main', 'sub']),
+    description: zod_1.z.string().optional(),
+    version: zod_1.z.number().positive().optional(),
+    element: zod_1.z.string().optional(),
+    phases: zod_1.z.array(exports.Phase).min(1),
+})
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/workflow/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/workflow/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "wingfoil",
+  "version": "0.2.1",
+  "description": "Open-source harness for AI-assisted software development that makes the process deterministic — Project Memory, Project DNA, Project Directives, Project Workflow, and a CLI + MCP interaction layer.",
+  "license": "MIT",
+  "author": "Roberto Pompermaier <robypomper@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robypomper/wingfoil.git"
+  },
+  "homepage": "https://github.com/robypomper/wingfoil#readme",
+  "bugs": {
+    "url": "https://github.com/robypomper/wingfoil/issues"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "dist/core/index.js",
+  "types": "dist/core/index.d.ts",
+  "bin": {
+    "wingfoil": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build && npm test && npm run lint",
+    "publish:staging": "node scripts/publish-staging.cjs",
+    "check:lockfile": "node scripts/check-lockfile-pins.cjs",
+    "lint": "eslint .",
+    "docs:api": "typedoc --options typedoc.json",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "wingfoil",
+    "ai-assisted-development",
+    "determinism"
+  ],
+  "//devDependencies:@emnapi": "task-104 / bug-063. @emnapi/core and @emnapi/runtime are NOT imported by anything in this repository. They are declared here, at the exact version the overrides block below pins, because an overrides pin binds a version but does not make npm record a node: under npm 11.x a plain `npm install` prunes both hoisted entries out of package-lock.json and reports `up to date`, which silently reverts task-080 and makes `npm ci` fail again under the npm 10.9.x that the pipeline's pinned Node 22.12.0 bundles (bug-056). A DIRECT dependency is never pruned, so declaring them is what makes the lock entries survive an ordinary install. Keep the two versions here equal to the overrides pins - `npm run check:lockfile` (scripts/check-lockfile-pins.cjs) fails if they drift, if either entry leaves the lock, or if these declarations are removed. Being devDependencies, they are never installed by a consumer of the published package.",
+  "devDependencies": {
+    "@emnapi/core": "1.11.3",
+    "@emnapi/runtime": "1.11.3",
+    "@eslint/js": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.20.4",
+    "eslint": "^10.6.0",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
+    "typedoc": "^0.28.20",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.110.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "chalk": "^4.1.2",
+    "commander": "^15.0.0",
+    "js-yaml": "^4.3.0",
+    "zod": "^4.4.3"
+  },
+  "//overrides": "task-080 / bug-056 / dl-069 option (b). @napi-rs/wasm-runtime (dev, optional, reached through eslint -> @unrs/resolver) declares @emnapi/core and @emnapi/runtime as REQUIRED peers, and npm recorded no hoisted entry for either - so npm resolved them from the registry on every install and `npm ci` then rejected the lock for missing what it had just resolved. That is invisible under npm 11.x and fatal under the npm 10.9.0 that the pipeline's pinned Node 22.12.0 bundles, which is why it surfaced only in the release gate. These exact pins make both peers resolve from package-lock.json instead of the registry. Scoped to @napi-rs/wasm-runtime on purpose: the nested @emnapi/core@1.10.0 under @unrs/resolver-binding-wasm32-wasi is a different edge and stays where it is. Revisit on any eslint / @unrs/resolver bump; test/cli/lockfile-peer-overrides.test.ts fails if the lock stops carrying these. task-104 amends this: the overrides block alone did NOT keep the entries in the lock - see the //devDependencies:@emnapi note above.",
+  "overrides": {
+    "@napi-rs/wasm-runtime": {
+      "@emnapi/core": "1.11.3",
+      "@emnapi/runtime": "1.11.3"
+    }
+  }
+}