feat: add goal-audit npm package (publish from loop-engineering) (#53)

Mirror tools/goal-audit from goal-engineering for npm releases via
release-goal-audit.yml tag workflow. Source of truth remains
cobusgreyling/goal-engineering.

Co-authored-by: Cobus Greyling <cobusgreyling@Cobuss-MacBook-Pro-2.local>

Author: cobusgreyling

.github/workflows/release-goal-audit.yml

@@ -0,0 +1,39 @@
+name: Release goal-audit
+
+on:
+  push:
+    tags:
+      - 'goal-audit-v*'
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  test-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+          cache-dependency-path: tools/goal-audit/package-lock.json
+
+      - name: Ensure npm supports trusted publishing (OIDC)
+        run: npm install -g npm@latest
+
+      - name: Install, build, test
+        working-directory: tools/goal-audit
+        run: |
+          npm ci
+          npm run build
+          npm test
+
+      - name: Publish to npm
+        working-directory: tools/goal-audit
+        run: npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -29,6 +29,7 @@ build/
 **/node_modules/
 !tools/loop-audit/dist/
 !tools/loop-cost/dist/
+!tools/goal-audit/dist/
 *.egg-info/
 
 # State files that should not be committed in consumer projects (reference repo dogfoods STATE.md)

tools/goal-audit/README.md

@@ -0,0 +1,27 @@
+# goal-audit
+
+Goal Readiness Score CLI for Grok Build `/goal` workflows.
+
+## Install / run
+
+```bash
+npx @cobusgreyling/goal-audit .
+npx @cobusgreyling/goal-audit . --suggest
+npx @cobusgreyling/goal-audit . --json
+```
+
+## Levels
+
+| Level | Score | Meaning |
+|-------|-------|---------|
+| G0 | < 40 | Ad hoc `/goal` usage |
+| G1 | 40–59 | GOAL.md + assisted goals |
+| G2 | 60–79 | Verifier + test gates |
+| G3 | 80+ | CI, budget, run log |
+
+## Development
+
+```bash
+npm install
+npm test
+```

tools/goal-audit/dist/auditor.d.ts

@@ -0,0 +1,54 @@
+export interface GoalSignals {
+    goalFile: {
+        present: boolean;
+        path?: string;
+    };
+    goalConfig: {
+        present: boolean;
+    };
+    skills: {
+        count: number;
+        goalSkills: string[];
+    };
+    verifier: {
+        present: boolean;
+    };
+    scoper: {
+        present: boolean;
+    };
+    agentsMd: {
+        present: boolean;
+        mentionsGoal: boolean;
+    };
+    patterns: {
+        documented: boolean;
+    };
+    safety: {
+        safetyDocPresent: boolean;
+        budgetDoc: boolean;
+    };
+    tests: {
+        present: boolean;
+    };
+    ci: {
+        present: boolean;
+    };
+    runLog: {
+        present: boolean;
+    };
+}
+export interface Finding {
+    level: 'ok' | 'warn' | 'fail';
+    message: string;
+}
+export interface AuditResult {
+    target: string;
+    score: number;
+    level: 'G0' | 'G1' | 'G2' | 'G3';
+    assessment: string;
+    signals: GoalSignals;
+    findings: Finding[];
+    recommendations: string[];
+}
+export declare function auditProject(target: string): Promise<AuditResult>;
+//# sourceMappingURL=auditor.d.ts.map